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

package/src/attendee.ts

@@ -1,79 +1,85 @@
 'use strict';
 
-
-import {addOrGetCustomAttributes, checkEnum, checkNameAndMail, escape} from './tools.ts';
-import type ICalEvent from './event.ts';
 import type ICalAlarm from './alarm.ts';
+import type ICalEvent from './event.ts';
 
-
-interface ICalInternalAttendeeData {
-    name: string | null;
-    email: string;
-    mailto: string | null;
-    sentBy: string | null;
-    status: ICalAttendeeStatus | null;
-    role: ICalAttendeeRole;
-    rsvp: boolean | null;
-    type: ICalAttendeeType | null;
-    delegatedTo: ICalAttendee | null;
-    delegatedFrom: ICalAttendee | null;
-    x: [string, string][];
-}
-
-export interface ICalAttendeeData {
-    name?: string | null;
-    email: string;
-    mailto?: string | null;
-    sentBy?: string | null;
-    status?: ICalAttendeeStatus | null;
-    role?: ICalAttendeeRole;
-    rsvp?: boolean | null;
-    type?: ICalAttendeeType | null;
-    delegatedTo?: ICalAttendee | ICalAttendeeData | string | null;
-    delegatedFrom?: ICalAttendee | ICalAttendeeData | string | null;
-    delegatesTo?: ICalAttendee | ICalAttendeeData | string | null;
-    delegatesFrom?: ICalAttendee | ICalAttendeeData | string | null;
-    x?: {key: string, value: string}[] | [string, string][] | Record<string, string>;
-}
-
-export interface ICalAttendeeJSONData {
-    name: string | null;
-    email: string;
-    mailto: string | null;
-    sentBy: string | null;
-    status: ICalAttendeeStatus | null;
-    role: ICalAttendeeRole;
-    rsvp: boolean | null;
-    type: ICalAttendeeType | null;
-    delegatedTo: string | null;
-    delegatedFrom: string | null;
-    x: {key: string, value: string}[];
-}
+import {
+    addOrGetCustomAttributes,
+    checkEnum,
+    checkNameAndMail,
+    escape,
+} from './tools.ts';
 
 export enum ICalAttendeeRole {
     CHAIR = 'CHAIR',
-    REQ = 'REQ-PARTICIPANT',
+    NON = 'NON-PARTICIPANT',
     OPT = 'OPT-PARTICIPANT',
-    NON = 'NON-PARTICIPANT'
+    REQ = 'REQ-PARTICIPANT',
 }
 
 export enum ICalAttendeeStatus {
     ACCEPTED = 'ACCEPTED',
-    TENTATIVE = 'TENTATIVE',
     DECLINED = 'DECLINED',
     DELEGATED = 'DELEGATED',
-    NEEDSACTION = 'NEEDS-ACTION'
+    NEEDSACTION = 'NEEDS-ACTION',
+    TENTATIVE = 'TENTATIVE',
 }
 
 // ref: https://tools.ietf.org/html/rfc2445#section-4.2.3
 export enum ICalAttendeeType {
-    INDIVIDUAL = 'INDIVIDUAL',
     GROUP = 'GROUP',
+    INDIVIDUAL = 'INDIVIDUAL',
     RESOURCE = 'RESOURCE',
     ROOM = 'ROOM',
-    UNKNOWN = 'UNKNOWN'
+    UNKNOWN = 'UNKNOWN',
+}
+
+export interface ICalAttendeeData {
+    delegatedFrom?: ICalAttendee | ICalAttendeeData | null | string;
+    delegatedTo?: ICalAttendee | ICalAttendeeData | null | string;
+    delegatesFrom?: ICalAttendee | ICalAttendeeData | null | string;
+    delegatesTo?: ICalAttendee | ICalAttendeeData | null | string;
+    email: string;
+    mailto?: null | string;
+    name?: null | string;
+    role?: ICalAttendeeRole;
+    rsvp?: boolean | null;
+    sentBy?: null | string;
+    status?: ICalAttendeeStatus | null;
+    type?: ICalAttendeeType | null;
+    x?:
+        | [string, string][]
+        | Record<string, string>
+        | { key: string; value: string }[];
 }
 
+export interface ICalAttendeeJSONData {
+    delegatedFrom: null | string;
+    delegatedTo: null | string;
+    email: string;
+    mailto: null | string;
+    name: null | string;
+    role: ICalAttendeeRole;
+    rsvp: boolean | null;
+    sentBy: null | string;
+    status: ICalAttendeeStatus | null;
+    type: ICalAttendeeType | null;
+    x: { key: string; value: string }[];
+}
+
+interface ICalInternalAttendeeData {
+    delegatedFrom: ICalAttendee | null;
+    delegatedTo: ICalAttendee | null;
+    email: string;
+    mailto: null | string;
+    name: null | string;
+    role: ICalAttendeeRole;
+    rsvp: boolean | null;
+    sentBy: null | string;
+    status: ICalAttendeeStatus | null;
+    type: ICalAttendeeType | null;
+    x: [string, string][];
+}
 
 /**
  * Usually you get an {@link ICalAttendee} object like this:
@@ -95,7 +101,7 @@ export enum ICalAttendeeType {
  */
 export default class ICalAttendee {
     private readonly data: ICalInternalAttendeeData;
-    private readonly parent: ICalEvent | ICalAlarm;
+    private readonly parent: ICalAlarm | ICalEvent;
 
     /**
      * Constructor of {@link ICalAttendee}. The event reference is
@@ -104,19 +110,19 @@ export default class ICalAttendee {
      * @param data Attendee Data
      * @param parent Reference to ICalEvent object
      */
-    constructor(data: ICalAttendeeData, parent: ICalEvent | ICalAlarm) {
+    constructor(data: ICalAttendeeData, parent: ICalAlarm | ICalEvent) {
         this.data = {
-            name: null,
+            delegatedFrom: null,
+            delegatedTo: null,
             email: '',
             mailto: null,
-            sentBy: null,
-            status: null,
+            name: null,
             role: ICalAttendeeRole.REQ,
             rsvp: null,
+            sentBy: null,
+            status: null,
             type: null,
-            delegatedTo: null,
-            delegatedFrom: null,
-            x: []
+            x: [],
         };
         this.parent = parent;
         if (!this.parent) {
@@ -135,46 +141,182 @@ export default class ICalAttendee {
         if (data.rsvp !== undefined) this.rsvp(data.rsvp);
         if (data.type !== undefined) this.type(data.type);
         if (data.delegatedTo !== undefined) this.delegatedTo(data.delegatedTo);
-        if (data.delegatedFrom !== undefined) this.delegatedFrom(data.delegatedFrom);
+        if (data.delegatedFrom !== undefined)
+            this.delegatedFrom(data.delegatedFrom);
         if (data.delegatesTo) this.delegatesTo(data.delegatesTo);
         if (data.delegatesFrom) this.delegatesFrom(data.delegatesFrom);
         if (data.x !== undefined) this.x(data.x);
     }
 
-
     /**
-     * Get the attendee's name
+     * Get the attendee's delegated-from field
      * @since 0.2.0
      */
-    name(): string | null;
+    delegatedFrom(): ICalAttendee | null;
+    /**
+     * Set the attendee's delegated-from field
+     *
+     * Creates a new Attendee if the passed object is not already a
+     * {@link ICalAttendee} object. Will set the `delegatedTo` and
+     * `delegatedFrom` attributes.
+     *
+     * @param delegatedFrom
+     */
+    delegatedFrom(
+        delegatedFrom: ICalAttendee | ICalAttendeeData | null | string,
+    ): this;
+    delegatedFrom(
+        delegatedFrom?: ICalAttendee | ICalAttendeeData | null | string,
+    ): ICalAttendee | null | this {
+        if (delegatedFrom === undefined) {
+            return this.data.delegatedFrom;
+        }
+
+        if (!delegatedFrom) {
+            this.data.delegatedFrom = null;
+        } else if (typeof delegatedFrom === 'string') {
+            this.data.delegatedFrom = new ICalAttendee(
+                {
+                    email: delegatedFrom,
+                    ...checkNameAndMail('delegatedFrom', delegatedFrom),
+                },
+                this.parent,
+            );
+        } else if (delegatedFrom instanceof ICalAttendee) {
+            this.data.delegatedFrom = delegatedFrom;
+        } else {
+            this.data.delegatedFrom = new ICalAttendee(
+                delegatedFrom,
+                this.parent,
+            );
+        }
+
+        return this;
+    }
 
     /**
-     * Set the attendee's name
+     * Get the attendee's delegated-to value.
      * @since 0.2.0
      */
-    name(name: string | null): this;
-    name(name?: string | null): this | string | null {
-        if (name === undefined) {
-            return this.data.name;
+    delegatedTo(): ICalAttendee | null;
+    /**
+     * Set the attendee's delegated-to field.
+     *
+     * Creates a new Attendee if the passed object is not already a
+     * {@link ICalAttendee} object. Will set the `delegatedTo` and
+     * `delegatedFrom` attributes.
+     *
+     * Will also set the `status` to `DELEGATED`, if attribute is set.
+     *
+     * ```javascript
+     * const cal = ical();
+     * const event = cal.createEvent();
+     * const attendee = cal.createAttendee();
+     *
+     * attendee.delegatesTo({email: 'foo@bar.com', name: 'Foo'});
+     ```
+     *
+     * @since 0.2.0
+     */
+    delegatedTo(
+        delegatedTo: ICalAttendee | ICalAttendeeData | null | string,
+    ): this;
+    delegatedTo(
+        delegatedTo?: ICalAttendee | ICalAttendeeData | null | string,
+    ): ICalAttendee | null | this {
+        if (delegatedTo === undefined) {
+            return this.data.delegatedTo;
+        }
+        if (!delegatedTo) {
+            this.data.delegatedTo = null;
+            if (this.data.status === ICalAttendeeStatus.DELEGATED) {
+                this.data.status = null;
+            }
+            return this;
         }
 
-        this.data.name = name || null;
+        if (typeof delegatedTo === 'string') {
+            this.data.delegatedTo = new ICalAttendee(
+                {
+                    email: delegatedTo,
+                    ...checkNameAndMail('delegatedTo', delegatedTo),
+                },
+                this.parent,
+            );
+        } else if (delegatedTo instanceof ICalAttendee) {
+            this.data.delegatedTo = delegatedTo;
+        } else {
+            this.data.delegatedTo = new ICalAttendee(delegatedTo, this.parent);
+        }
+
+        this.data.status = ICalAttendeeStatus.DELEGATED;
         return this;
     }
 
+    /**
+     * Create a new attendee this attendee delegates from and returns
+     * this new attendee. Creates a new attendee if the passed object
+     * is not already an {@link ICalAttendee}.
+     *
+     * ```javascript
+     * const cal = ical();
+     * const event = cal.createEvent();
+     * const attendee = cal.createAttendee();
+     *
+     * attendee.delegatesFrom({email: 'foo@bar.com', name: 'Foo'});
+     * ```
+     *
+     * @since 0.2.0
+     */
+    delegatesFrom(
+        options: ICalAttendee | ICalAttendeeData | string,
+    ): ICalAttendee {
+        const a =
+            options instanceof ICalAttendee
+                ? options
+                : this.parent.createAttendee(options);
+        this.delegatedFrom(a);
+        a.delegatedTo(this);
+        return a;
+    }
 
+    /**
+     * Create a new attendee this attendee delegates to and returns
+     * this new attendee. Creates a new attendee if the passed object
+     * is not already an {@link ICalAttendee}.
+     *
+     * ```javascript
+     * const cal = ical();
+     * const event = cal.createEvent();
+     * const attendee = cal.createAttendee();
+     *
+     * attendee.delegatesTo({email: 'foo@bar.com', name: 'Foo'});
+     * ```
+     *
+     * @since 0.2.0
+     */
+    delegatesTo(
+        options: ICalAttendee | ICalAttendeeData | string,
+    ): ICalAttendee {
+        const a =
+            options instanceof ICalAttendee
+                ? options
+                : this.parent.createAttendee(options);
+        this.delegatedTo(a);
+        a.delegatedFrom(this);
+        return a;
+    }
     /**
      * Get the attendee's email address
      * @since 0.2.0
      */
     email(): string;
-
     /**
      * Set the attendee's email address
      * @since 0.2.0
      */
     email(email: string): this;
-    email(email?: string): this | string {
+    email(email?: string): string | this {
         if (!email) {
             return this.data.email;
         }
@@ -182,19 +324,17 @@ export default class ICalAttendee {
         this.data.email = email;
         return this;
     }
-
     /**
      * Get the attendee's email address
      * @since 1.3.0
      */
-    mailto(): string | null;
-
+    mailto(): null | string;
     /**
      * Set the attendee's email address
      * @since 1.3.0
      */
-    mailto(mailto: string | null): this;
-    mailto(mailto?: string | null): this | string | null {
+    mailto(mailto: null | string): this;
+    mailto(mailto?: null | string): null | string | this {
         if (mailto === undefined) {
             return this.data.mailto;
         }
@@ -202,35 +342,29 @@ export default class ICalAttendee {
         this.data.mailto = mailto || null;
         return this;
     }
-
-
     /**
-     * Get the acting user's email adress
-     * @since 3.3.0
+     * Get the attendee's name
+     * @since 0.2.0
      */
-    sentBy(): string | null;
-
+    name(): null | string;
     /**
-     * Set the acting user's email adress
-     * @since 3.3.0
+     * Set the attendee's name
+     * @since 0.2.0
      */
-    sentBy(email: string | null): this;
-    sentBy(email?: string | null): this | string | null {
-        if (!email) {
-            return this.data.sentBy;
+    name(name: null | string): this;
+    name(name?: null | string): null | string | this {
+        if (name === undefined) {
+            return this.data.name;
         }
 
-        this.data.sentBy = email;
+        this.data.name = name || null;
         return this;
     }
-
-
     /**
      * Get attendee's role
      * @since 0.2.0
      */
     role(): ICalAttendeeRole;
-
     /**
      * Set the attendee's role, defaults to `REQ` / `REQ-PARTICIPANT`.
      * Checkout {@link ICalAttendeeRole} for available roles.
@@ -238,7 +372,7 @@ export default class ICalAttendee {
      * @since 0.2.0
      */
     role(role: ICalAttendeeRole): this;
-    role(role?: ICalAttendeeRole): this | ICalAttendeeRole {
+    role(role?: ICalAttendeeRole): ICalAttendeeRole | this {
         if (role === undefined) {
             return this.data.role;
         }
@@ -246,20 +380,17 @@ export default class ICalAttendee {
         this.data.role = checkEnum(ICalAttendeeRole, role) as ICalAttendeeRole;
         return this;
     }
-
-
     /**
      * Get attendee's RSVP expectation
      * @since 0.2.1
      */
     rsvp(): boolean | null;
-
     /**
      * Set the attendee's RSVP expectation
      * @since 0.2.1
      */
     rsvp(rsvp: boolean | null): this;
-    rsvp(rsvp?: boolean | null): this | boolean | null {
+    rsvp(rsvp?: boolean | null): boolean | null | this {
         if (rsvp === undefined) {
             return this.data.rsvp;
         }
@@ -271,14 +402,29 @@ export default class ICalAttendee {
         this.data.rsvp = Boolean(rsvp);
         return this;
     }
+    /**
+     * Get the acting user's email adress
+     * @since 3.3.0
+     */
+    sentBy(): null | string;
+    /**
+     * Set the acting user's email adress
+     * @since 3.3.0
+     */
+    sentBy(email: null | string): this;
+    sentBy(email?: null | string): null | string | this {
+        if (!email) {
+            return this.data.sentBy;
+        }
 
-
+        this.data.sentBy = email;
+        return this;
+    }
     /**
      * Get attendee's status
      * @since 0.2.0
      */
     status(): ICalAttendeeStatus | null;
-
     /**
      * Set the attendee's status. See {@link ICalAttendeeStatus}
      * for available status options.
@@ -286,7 +432,9 @@ export default class ICalAttendee {
      * @since 0.2.0
      */
     status(status: ICalAttendeeStatus | null): this;
-    status(status?: ICalAttendeeStatus | null): this | ICalAttendeeStatus | null {
+    status(
+        status?: ICalAttendeeStatus | null,
+    ): ICalAttendeeStatus | null | this {
         if (status === undefined) {
             return this.data.status;
         }
@@ -295,178 +443,126 @@ export default class ICalAttendee {
             return this;
         }
 
-        this.data.status = checkEnum(ICalAttendeeStatus, status) as ICalAttendeeStatus;
+        this.data.status = checkEnum(
+            ICalAttendeeStatus,
+            status,
+        ) as ICalAttendeeStatus;
         return this;
     }
-
-
     /**
-     * Get attendee's type (a.k.a. CUTYPE)
-     * @since 0.2.3
-     */
-    type(): ICalAttendeeType;
-
-    /**
-     * Set attendee's type (a.k.a. CUTYPE).
-     * See {@link ICalAttendeeType} for available status options.
+     * Return a shallow copy of the attendee's options for JSON stringification.
+     * Can be used for persistence.
      *
-     * @since 0.2.3
+     * @since 0.2.4
      */
-    type(type: ICalAttendeeType | null): this;
-    type(type?: ICalAttendeeType | null): this | ICalAttendeeType | null {
-        if (type === undefined) {
-            return this.data.type;
-        }
-        if (!type) {
-            this.data.type = null;
-            return this;
-        }
-
-        this.data.type = checkEnum(ICalAttendeeType, type) as ICalAttendeeType;
-        return this;
+    toJSON(): ICalAttendeeJSONData {
+        return Object.assign({}, this.data, {
+            delegatedFrom: this.data.delegatedFrom?.email() || null,
+            delegatedTo: this.data.delegatedTo?.email() || null,
+            x: this.x(),
+        });
     }
 
-
-    /**
-     * Get the attendee's delegated-to value.
-     * @since 0.2.0
-     */
-    delegatedTo(): ICalAttendee | null;
-
     /**
-     * Set the attendee's delegated-to field.
-     *
-     * Creates a new Attendee if the passed object is not already a
-     * {@link ICalAttendee} object. Will set the `delegatedTo` and
-     * `delegatedFrom` attributes.
-     *
-     * Will also set the `status` to `DELEGATED`, if attribute is set.
+     * Return generated attendee as a string.
      *
      * ```javascript
-     * const cal = ical();
-     * const event = cal.createEvent();
-     * const attendee = cal.createAttendee();
-     *
-     * attendee.delegatesTo({email: 'foo@bar.com', name: 'Foo'});
-     ```
-     *
-     * @since 0.2.0
+     * console.log(attendee.toString()); // → ATTENDEE;ROLE=…
+     * ```
      */
-    delegatedTo(delegatedTo: ICalAttendee | ICalAttendeeData | string | null): this;
-    delegatedTo(delegatedTo?: ICalAttendee | ICalAttendeeData | string | null): this | ICalAttendee | null {
-        if (delegatedTo === undefined) {
-            return this.data.delegatedTo;
-        }
-        if (!delegatedTo) {
-            this.data.delegatedTo = null;
-            if (this.data.status === ICalAttendeeStatus.DELEGATED) {
-                this.data.status = null;
-            }
-            return this;
-        }
+    toString(): string {
+        let g = 'ATTENDEE';
 
-        if(typeof delegatedTo === 'string') {
-            this.data.delegatedTo = new ICalAttendee(
-                { email: delegatedTo, ...checkNameAndMail('delegatedTo', delegatedTo) },
-                this.parent,
-            );
-        }
-        else if(delegatedTo instanceof ICalAttendee) {
-            this.data.delegatedTo = delegatedTo;
-        }
-        else {
-            this.data.delegatedTo = new ICalAttendee(delegatedTo, this.parent);
+        if (!this.data.email) {
+            throw new Error('No value for `email` in ICalAttendee given!');
         }
 
-        this.data.status = ICalAttendeeStatus.DELEGATED;
-        return this;
-    }
+        // ROLE
+        g += ';ROLE=' + this.data.role;
 
+        // TYPE
+        if (this.data.type) {
+            g += ';CUTYPE=' + this.data.type;
+        }
 
-    /**
-     * Get the attendee's delegated-from field
-     * @since 0.2.0
-     */
-    delegatedFrom (): ICalAttendee | null;
+        // PARTSTAT
+        if (this.data.status) {
+            g += ';PARTSTAT=' + this.data.status;
+        }
 
-    /**
-     * Set the attendee's delegated-from field
-     *
-     * Creates a new Attendee if the passed object is not already a
-     * {@link ICalAttendee} object. Will set the `delegatedTo` and
-     * `delegatedFrom` attributes.
-     *
-     * @param delegatedFrom
-     */
-    delegatedFrom (delegatedFrom: ICalAttendee | ICalAttendeeData | string | null): this;
-    delegatedFrom(delegatedFrom?: ICalAttendee | ICalAttendeeData | string | null): this | ICalAttendee | null {
-        if (delegatedFrom === undefined) {
-            return this.data.delegatedFrom;
+        // RSVP
+        if (this.data.rsvp !== null) {
+            g += ';RSVP=' + this.data.rsvp.toString().toUpperCase();
         }
 
-        if (!delegatedFrom) {
-            this.data.delegatedFrom = null;
+        // SENT-BY
+        if (this.data.sentBy !== null) {
+            g += ';SENT-BY="mailto:' + this.data.sentBy + '"';
         }
-        else if(typeof delegatedFrom === 'string') {
-            this.data.delegatedFrom = new ICalAttendee(
-                { email: delegatedFrom, ...checkNameAndMail('delegatedFrom', delegatedFrom) },
-                this.parent,
-            );
+
+        // DELEGATED-TO
+        if (this.data.delegatedTo) {
+            g += ';DELEGATED-TO="' + this.data.delegatedTo.email() + '"';
         }
-        else if(delegatedFrom instanceof ICalAttendee) {
-            this.data.delegatedFrom = delegatedFrom;
+
+        // DELEGATED-FROM
+        if (this.data.delegatedFrom) {
+            g += ';DELEGATED-FROM="' + this.data.delegatedFrom.email() + '"';
         }
-        else {
-            this.data.delegatedFrom = new ICalAttendee(delegatedFrom, this.parent);
+
+        // CN / Name
+        if (this.data.name) {
+            g += ';CN="' + escape(this.data.name, true) + '"';
         }
 
-        return this;
-    }
+        // EMAIL
+        if (this.data.email && this.data.mailto) {
+            g += ';EMAIL=' + escape(this.data.email, false);
+        }
 
+        // CUSTOM X ATTRIBUTES
+        if (this.data.x.length) {
+            g +=
+                ';' +
+                this.data.x
+                    .map(
+                        ([key, value]) =>
+                            key.toUpperCase() + '=' + escape(value, false),
+                    )
+                    .join(';');
+        }
+
+        g +=
+            ':MAILTO:' +
+            escape(this.data.mailto || this.data.email, false) +
+            '\r\n';
 
-    /**
-     * Create a new attendee this attendee delegates to and returns
-     * this new attendee. Creates a new attendee if the passed object
-     * is not already an {@link ICalAttendee}.
-     *
-     * ```javascript
-     * const cal = ical();
-     * const event = cal.createEvent();
-     * const attendee = cal.createAttendee();
-     *
-     * attendee.delegatesTo({email: 'foo@bar.com', name: 'Foo'});
-     * ```
-     *
-     * @since 0.2.0
-     */
-    delegatesTo (options: ICalAttendee | ICalAttendeeData | string): ICalAttendee {
-        const a = options instanceof ICalAttendee ? options : this.parent.createAttendee(options);
-        this.delegatedTo(a);
-        a.delegatedFrom(this);
-        return a;
+        return g;
     }
 
-
     /**
-     * Create a new attendee this attendee delegates from and returns
-     * this new attendee. Creates a new attendee if the passed object
-     * is not already an {@link ICalAttendee}.
-     *
-     * ```javascript
-     * const cal = ical();
-     * const event = cal.createEvent();
-     * const attendee = cal.createAttendee();
-     *
-     * attendee.delegatesFrom({email: 'foo@bar.com', name: 'Foo'});
-     * ```
+     * Get attendee's type (a.k.a. CUTYPE)
+     * @since 0.2.3
+     */
+    type(): ICalAttendeeType;
+    /**
+     * Set attendee's type (a.k.a. CUTYPE).
+     * See {@link ICalAttendeeType} for available status options.
      *
-     * @since 0.2.0
+     * @since 0.2.3
      */
-    delegatesFrom (options: ICalAttendee | ICalAttendeeData | string): ICalAttendee {
-        const a = options instanceof ICalAttendee ? options : this.parent.createAttendee(options);
-        this.delegatedFrom(a);
-        a.delegatedTo(this);
-        return a;
+    type(type: ICalAttendeeType | null): this;
+    type(type?: ICalAttendeeType | null): ICalAttendeeType | null | this {
+        if (type === undefined) {
+            return this.data.type;
+        }
+        if (!type) {
+            this.data.type = null;
+            return this;
+        }
+
+        this.data.type = checkEnum(ICalAttendeeType, type) as ICalAttendeeType;
+        return this;
     }
 
     /**
@@ -493,8 +589,12 @@ export default class ICalAttendee {
      *
      * @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. status),
@@ -506,113 +606,32 @@ export default class ICalAttendee {
      *
      * @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 attendee's options for JSON stringification.
-     * Can be used for persistence.
-     *
-     * @since 0.2.4
-     */
-    toJSON(): ICalAttendeeJSONData {
-        return Object.assign({}, this.data, {
-            delegatedTo: this.data.delegatedTo?.email() || null,
-            delegatedFrom: this.data.delegatedFrom?.email() || null,
-            x: this.x()
-        });
-    }
-
-
-    /**
-     * Return generated attendee as a string.
-     *
-     * ```javascript
-     * console.log(attendee.toString()); // → ATTENDEE;ROLE=…
-     * ```
-     */
-    toString (): string {
-        let g = 'ATTENDEE';
-
-        if (!this.data.email) {
-            throw new Error('No value for `email` in ICalAttendee given!');
-        }
-
-        // ROLE
-        g += ';ROLE=' + this.data.role;
-
-        // TYPE
-        if (this.data.type) {
-            g += ';CUTYPE=' + this.data.type;
-        }
-
-        // PARTSTAT
-        if (this.data.status) {
-            g += ';PARTSTAT=' + this.data.status;
-        }
-
-        // RSVP
-        if (this.data.rsvp !== null) {
-            g += ';RSVP=' + this.data.rsvp.toString().toUpperCase();
-        }
-
-        // SENT-BY
-        if (this.data.sentBy !== null) {
-            g += ';SENT-BY="mailto:' + this.data.sentBy + '"';
-        }
-
-        // DELEGATED-TO
-        if (this.data.delegatedTo) {
-            g += ';DELEGATED-TO="' + this.data.delegatedTo.email() + '"';
-        }
-
-        // DELEGATED-FROM
-        if (this.data.delegatedFrom) {
-            g += ';DELEGATED-FROM="' + this.data.delegatedFrom.email() + '"';
-        }
-
-        // CN / Name
-        if (this.data.name) {
-            g += ';CN="' + escape(this.data.name, true) + '"';
-        }
-
-        // EMAIL
-        if (this.data.email && this.data.mailto) {
-            g += ';EMAIL=' + escape(this.data.email, false);
-        }
-
-        // CUSTOM X ATTRIBUTES
-        if(this.data.x.length) {
-            g += ';' + this.data.x
-                .map(([key, value]) => key.toUpperCase() + '=' + escape(value, false))
-                .join(';');
-        }
-
-        g += ':MAILTO:' + escape(this.data.mailto || this.data.email, false) + '\r\n';
-
-        return g;
-    }
 }