iamcal 1.1.1 → 2.1.0

package/lib/components/CalendarEvent.d.ts

@@ -0,0 +1,109 @@
+import { Component } from '../component';
+import { CalendarDateTime, CalendarDateOrTime } from '../date';
+/**
+ * Represents a VEVENT component, representing an event in a calendar.
+ */
+export declare class CalendarEvent extends Component {
+    name: string;
+    constructor(uid: string, dtstamp: CalendarDateTime | Date, dtstart: CalendarDateOrTime | Date);
+    constructor(component: Component);
+    serialize(): string;
+    validate(): void;
+    getStamp(): CalendarDateTime;
+    setStamp(value: CalendarDateTime | Date): this;
+    getUid(): string;
+    setUid(value: string): this;
+    getSummary(): string | undefined;
+    setSummary(value: string): this;
+    removeSummary(): void;
+    getDescription(): string | undefined;
+    setDescription(value: string): this;
+    removeDescription(): void;
+    getLocation(): string | undefined;
+    setLocation(value: string): this;
+    removeLocation(): void;
+    /**
+     * Get the start date or time of the event.
+     * @returns The start date or time of the event as a {@link CalendarDateOrTime}.
+     */
+    getStart(): CalendarDateOrTime;
+    /**
+     * Set the start date or time of the event.
+     * @param value The start date of the event as a {@link CalendarDateOrTime} or `Date`.
+     * @returns The CalendarEvent instance for chaining.
+     */
+    setStart(value: CalendarDateOrTime | Date): this;
+    /**
+     * Get the non-inclusive end of the event.
+     * @returns The end date of the event as a {@link CalendarDateOrTime} or `undefined` if not set.
+     */
+    getEnd(): CalendarDateOrTime | undefined;
+    /**
+     * Set the exclusive end of the event.
+     *
+     * Will remove 'duration' if present.
+     * @param value The end date of the event as a {@link CalendarDateOrTime} or `Date`.
+     * @returns The CalendarEvent instance for chaining.
+     * @throws If the end date is a full day date and the start date is a date-time, or vice versa.
+     */
+    setEnd(value: CalendarDateOrTime | Date): this;
+    /**
+     * Remove the end of the event.
+     *
+     * NOTE: An event must have either an end or a duration set.
+     */
+    removeEnd(): void;
+    /**
+     * Get the duration of the event as a string formatted according to the iCalendar specification.
+     * @returns The duration of the event, or `undefined` if not set.
+     */
+    getDuration(): string | undefined;
+    /**
+     * Set the duration of the event.
+     *
+     * Will remove 'end' if present.
+     * @param value The duration of the event as a string in the format defined by RFC5545.
+     * @returns The CalendarEvent instance for chaining.
+     * @example
+     * // Set duration to 1 hour and 30 minutes.
+     * event.setDuration(`PT1H30M`)
+     */
+    setDuration(value: string): this;
+    /**
+     * Remove the duration of the event.
+     *
+     * NOTE: An event must have either an end or a duration set.
+     */
+    removeDuration(): void;
+    getCreated(): CalendarDateOrTime | undefined;
+    setCreated(value: Date): this;
+    removeCreated(): void;
+    getGeographicPosition(): [number, number] | undefined;
+    setGeographicPosition(latitude: number, longitude: number): this;
+    removeGeographicLocation(): void;
+    /** @deprecated use {@link getStamp} instead */
+    stamp: () => CalendarDateTime;
+    /** @deprecated use {@link getUid} instead */
+    uid: () => string;
+    /** @deprecated use {@link getSummary} instead */
+    summary: () => string | undefined;
+    /** @deprecated use {@link getDescription} instead */
+    description: () => string | undefined;
+    /** @deprecated use {@link getLocation} instead */
+    location: () => string | undefined;
+    /** @deprecated use {@link getStart} instead */
+    start: () => CalendarDateOrTime;
+    /** @deprecated use {@link getEnd} instead */
+    end: () => CalendarDateOrTime | undefined;
+    /** @deprecated use {@link getDuration} instead */
+    duration: () => string | undefined;
+    /** @deprecated use {@link getCreated} instead */
+    created: () => CalendarDateOrTime | undefined;
+    /** @deprecated use {@link getGeographicPosition} instead */
+    geo: () => [number, number] | undefined;
+    /** @deprecated use {@link setGeographicPosition} instead */
+    setGeo: (latitude: number, longitude: number) => this;
+    /** @deprecated use {@link removeGeographicLocation} instead */
+    removeGeo: () => void;
+}
+//# sourceMappingURL=CalendarEvent.d.ts.map

package/lib/components/CalendarEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CalendarEvent.d.ts","sourceRoot":"","sources":["../../src/components/CalendarEvent.ts"],"names":[],"mappings":"AACA,OAAO,EAA4B,SAAS,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EACH,gBAAgB,EAEhB,kBAAkB,EAGrB,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;IACxC,IAAI,SAAW;gBAGX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,OAAO,EAAE,kBAAkB,GAAG,IAAI;gBAE1B,SAAS,EAAE,SAAS;IAsBhC,SAAS,IAAI,MAAM;IASnB,QAAQ;IAWR,QAAQ,IAAI,gBAAgB;IAM5B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAQ9C,MAAM,IAAI,MAAM;IAIhB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3B,UAAU,IAAI,MAAM,GAAG,SAAS;IAIhC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B,aAAa;IAIb,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC,iBAAiB;IAIjB,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,cAAc;IAId;;;OAGG;IACH,QAAQ,IAAI,kBAAkB;IAI9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI;IAIhD;;;OAGG;IACH,MAAM,IAAI,kBAAkB,GAAG,SAAS;IAMxC;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI;IAa9C;;;;OAIG;IACH,SAAS;IAIT;;;OAGG;IACH,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC;;;;;;;;;OASG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKhC;;;;OAIG;IACH,cAAc;IAId,UAAU,IAAI,kBAAkB,GAAG,SAAS;IAM5C,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAI7B,aAAa;IAIb,qBAAqB,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAUrD,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKhE,wBAAwB;IAMxB,+CAA+C;IAC/C,KAAK,QAvLO,gBAAgB,CAuLP;IACrB,6CAA6C;IAC7C,GAAG,QA3KO,MAAM,CA2KC;IACjB,iDAAiD;IACjD,OAAO,QArKO,MAAM,GAAG,SAAS,CAqKP;IACzB,qDAAqD;IACrD,WAAW,QA3JO,MAAM,GAAG,SAAS,CA2JH;IACjC,kDAAkD;IAClD,QAAQ,QAjJO,MAAM,GAAG,SAAS,CAiJN;IAC3B,+CAA+C;IAC/C,KAAK,QAnIO,kBAAkB,CAmIT;IACrB,6CAA6C;IAC7C,GAAG,QApHO,kBAAkB,GAAG,SAAS,CAoHvB;IACjB,kDAAkD;IAClD,QAAQ,QA9EO,MAAM,GAAG,SAAS,CA8EN;IAC3B,iDAAiD;IACjD,OAAO,QApDO,kBAAkB,GAAG,SAAS,CAoDnB;IACzB,4DAA4D;IAC5D,GAAG,QAxCsB,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAwCrB;IAChC,4DAA4D;IAC5D,MAAM,aAhC0B,MAAM,aAAa,MAAM,KAAG,IAAI,CAgC7B;IACnC,+DAA+D;IAC/D,SAAS,aAAgC;CAC5C"}

package/lib/components/CalendarEvent.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalendarEvent = void 0;
+const property_1 = require("../property");
+const component_1 = require("../component");
+const date_1 = require("../date");
+/**
+ * Represents a VEVENT component, representing an event in a calendar.
+ */
+class CalendarEvent extends component_1.Component {
+    name = 'VEVENT';
+    constructor(a, b, c) {
+        let component;
+        if (a instanceof component_1.Component) {
+            component = a;
+            CalendarEvent.prototype.validate.call(component);
+        }
+        else {
+            const uid = a;
+            const dtstamp = (0, date_1.convertDate)(b, false);
+            const dtstart = (0, date_1.convertDate)(c);
+            component = new component_1.Component('VEVENT');
+            component.setProperty('UID', uid);
+            component.setProperty('DTSTAMP', dtstamp);
+            component.setProperty('DTSTART', dtstart);
+        }
+        super(component.name, component.properties, component.components);
+    }
+    serialize() {
+        if (!this.getEnd() && !this.duration()) {
+            throw new Error('Failed to serialize calendar event, end or duration must be set');
+        }
+        return super.serialize();
+    }
+    validate() {
+        if (this.name !== 'VEVENT')
+            throw new component_1.ComponentValidationError('Component name must be VEVENT');
+        const requiredProperties = [
+            'UID',
+            'DTSTAMP',
+            'DTSTART',
+        ];
+        this.validateAllProperties(requiredProperties);
+    }
+    getStamp() {
+        return (0, date_1.parseDateProperty)(this.getProperty('DTSTAMP'));
+    }
+    setStamp(value) {
+        const converted = (0, date_1.convertDate)(value, false);
+        if (converted.isFullDay()) {
+            throw new property_1.PropertyValidationError('DTSTAMP cannot be of type DATE');
+        }
+        return this.setProperty('DTSTAMP', converted);
+    }
+    getUid() {
+        return this.getProperty('UID').value;
+    }
+    setUid(value) {
+        return this.setProperty('UID', value);
+    }
+    getSummary() {
+        return this.getProperty('SUMMARY')?.value;
+    }
+    setSummary(value) {
+        return this.setProperty('SUMMARY', value);
+    }
+    removeSummary() {
+        this.removePropertiesWithName('SUMMARY');
+    }
+    getDescription() {
+        return this.getProperty('DESCRIPTION')?.value;
+    }
+    setDescription(value) {
+        return this.setProperty('DESCRIPTION', value);
+    }
+    removeDescription() {
+        this.removePropertiesWithName('DESCRIPTION');
+    }
+    getLocation() {
+        return this.getProperty('LOCATION')?.value;
+    }
+    setLocation(value) {
+        return this.setProperty('LOCATION', value);
+    }
+    removeLocation() {
+        this.removePropertiesWithName('LOCATION');
+    }
+    /**
+     * Get the start date or time of the event.
+     * @returns The start date or time of the event as a {@link CalendarDateOrTime}.
+     */
+    getStart() {
+        return (0, date_1.parseDateProperty)(this.getProperty('DTSTART'));
+    }
+    /**
+     * Set the start date or time of the event.
+     * @param value The start date of the event as a {@link CalendarDateOrTime} or `Date`.
+     * @returns The CalendarEvent instance for chaining.
+     */
+    setStart(value) {
+        return this.setProperty('DTSTART', (0, date_1.convertDate)(value));
+    }
+    /**
+     * Get the non-inclusive end of the event.
+     * @returns The end date of the event as a {@link CalendarDateOrTime} or `undefined` if not set.
+     */
+    getEnd() {
+        const property = this.getProperty('DTEND');
+        if (!property)
+            return;
+        return (0, date_1.parseDateProperty)(property);
+    }
+    /**
+     * Set the exclusive end of the event.
+     *
+     * Will remove 'duration' if present.
+     * @param value The end date of the event as a {@link CalendarDateOrTime} or `Date`.
+     * @returns The CalendarEvent instance for chaining.
+     * @throws If the end date is a full day date and the start date is a date-time, or vice versa.
+     */
+    setEnd(value) {
+        const date = (0, date_1.convertDate)(value);
+        const start = this.getStart();
+        if (date.isFullDay() !== start.isFullDay()) {
+            throw new Error(`End must be same date type as start. Start is ${start.isFullDay() ? 'date' : 'datetime'} but new end value is ${date.isFullDay() ? 'date' : 'datetime'}`);
+        }
+        this.removeDuration();
+        return this.setProperty('DTEND', date);
+    }
+    /**
+     * Remove the end of the event.
+     *
+     * NOTE: An event must have either an end or a duration set.
+     */
+    removeEnd() {
+        this.removePropertiesWithName('DTEND');
+    }
+    /**
+     * Get the duration of the event as a string formatted according to the iCalendar specification.
+     * @returns The duration of the event, or `undefined` if not set.
+     */
+    getDuration() {
+        return this.getProperty('DURATION')?.value;
+    }
+    /**
+     * Set the duration of the event.
+     *
+     * Will remove 'end' if present.
+     * @param value The duration of the event as a string in the format defined by RFC5545.
+     * @returns The CalendarEvent instance for chaining.
+     * @example
+     * // Set duration to 1 hour and 30 minutes.
+     * event.setDuration(`PT1H30M`)
+     */
+    setDuration(value) {
+        this.removeEnd();
+        return this.setProperty('DURATION', value);
+    }
+    /**
+     * Remove the duration of the event.
+     *
+     * NOTE: An event must have either an end or a duration set.
+     */
+    removeDuration() {
+        this.removePropertiesWithName('DURATION');
+    }
+    getCreated() {
+        const property = this.getProperty('CREATED');
+        if (!property)
+            return;
+        return (0, date_1.parseDateProperty)(property);
+    }
+    setCreated(value) {
+        return this.setProperty('CREATED', (0, date_1.toDateTimeString)(value));
+    }
+    removeCreated() {
+        this.removePropertiesWithName('CREATED');
+    }
+    getGeographicPosition() {
+        const text = this.getProperty('GEO')?.value;
+        if (!text)
+            return;
+        const validGeoPattern = /^[+-]?\d+(\.\d+)?;[+-]?\d+(\.\d+)?$/;
+        if (!validGeoPattern.test(text))
+            throw new Error(`Failed to parse GEO property: ${text}`);
+        const [longitude, latitude] = text.split(',');
+        return [parseFloat(longitude), parseFloat(latitude)];
+    }
+    setGeographicPosition(latitude, longitude) {
+        const text = `${latitude};${longitude}`;
+        return this.setProperty('GEO', text);
+    }
+    removeGeographicLocation() {
+        this.removePropertiesWithName('GEO');
+    }
+    /* eslint-disable */
+    /** @deprecated use {@link getStamp} instead */
+    stamp = this.getStamp;
+    /** @deprecated use {@link getUid} instead */
+    uid = this.getUid;
+    /** @deprecated use {@link getSummary} instead */
+    summary = this.getSummary;
+    /** @deprecated use {@link getDescription} instead */
+    description = this.getDescription;
+    /** @deprecated use {@link getLocation} instead */
+    location = this.getLocation;
+    /** @deprecated use {@link getStart} instead */
+    start = this.getStart;
+    /** @deprecated use {@link getEnd} instead */
+    end = this.getEnd;
+    /** @deprecated use {@link getDuration} instead */
+    duration = this.getDuration;
+    /** @deprecated use {@link getCreated} instead */
+    created = this.getCreated;
+    /** @deprecated use {@link getGeographicPosition} instead */
+    geo = this.getGeographicPosition;
+    /** @deprecated use {@link setGeographicPosition} instead */
+    setGeo = this.setGeographicPosition;
+    /** @deprecated use {@link removeGeographicLocation} instead */
+    removeGeo = this.removeGeographicLocation;
+}
+exports.CalendarEvent = CalendarEvent;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ2FsZW5kYXJFdmVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb21wb25lbnRzL0NhbGVuZGFyRXZlbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsMENBQXdFO0FBQ3hFLDRDQUFrRTtBQUNsRSxrQ0FNZ0I7QUFFaEI7O0dBRUc7QUFDSCxNQUFhLGFBQWMsU0FBUSxxQkFBUztJQUN4QyxJQUFJLEdBQUcsUUFBUSxDQUFBO0lBUWYsWUFDSSxDQUFxQixFQUNyQixDQUEyQixFQUMzQixDQUE2QjtRQUU3QixJQUFJLFNBQW9CLENBQUE7UUFDeEIsSUFBSSxDQUFDLFlBQVkscUJBQVMsRUFBRSxDQUFDO1lBQ3pCLFNBQVMsR0FBRyxDQUFjLENBQUE7WUFDMUIsYUFBYSxDQUFDLFNBQVMsQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFBO1FBQ3BELENBQUM7YUFBTSxDQUFDO1lBQ0osTUFBTSxHQUFHLEdBQUcsQ0FBVyxDQUFBO1lBQ3ZCLE1BQU0sT0FBTyxHQUFHLElBQUEsa0JBQVcsRUFBQyxDQUFFLEVBQUUsS0FBSyxDQUFDLENBQUE7WUFDdEMsTUFBTSxPQUFPLEdBQUcsSUFBQSxrQkFBVyxFQUFDLENBQUUsQ0FBQyxDQUFBO1lBQy9CLFNBQVMsR0FBRyxJQUFJLHFCQUFTLENBQUMsUUFBUSxDQUFDLENBQUE7WUFDbkMsU0FBUyxDQUFDLFdBQVcsQ0FBQyxLQUFLLEVBQUUsR0FBRyxDQUFDLENBQUE7WUFDakMsU0FBUyxDQUFDLFdBQVcsQ0FBQyxTQUFTLEVBQUUsT0FBTyxDQUFDLENBQUE7WUFDekMsU0FBUyxDQUFDLFdBQVcsQ0FBQyxTQUFTLEVBQUUsT0FBTyxDQUFDLENBQUE7UUFDN0MsQ0FBQztRQUNELEtBQUssQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFLFNBQVMsQ0FBQyxVQUFVLEVBQUUsU0FBUyxDQUFDLFVBQVUsQ0FBQyxDQUFBO0lBQ3JFLENBQUM7SUFFRCxTQUFTO1FB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

package/lib/components/TimeZone.d.ts

@@ -0,0 +1,74 @@
+import { Component } from '../component';
+import { CalendarDateOrTime } from '../date';
+import { TimeZoneOffset } from './TimeZoneOffset';
+/**
+ * Represents a VTIMEZONE component, containing time zone definitions.
+ */
+export declare class TimeZone extends Component {
+    name: string;
+    constructor(id: string);
+    constructor(component: Component);
+    validate(): void;
+    getId(): string;
+    setId(value: string): this;
+    getLastModified(): CalendarDateOrTime | undefined;
+    setLastModified(value: Date): this;
+    removeLastModified(): void;
+    getUrl(): string | undefined;
+    setUrl(value: string): this;
+    removeUrl(): void;
+    /**
+     * Get all time offsets.
+     * @returns An array of time zone offsets defined in this time zone.
+     */
+    getOffsets(): TimeZoneOffset[];
+    /**
+     * Get standard/winter time offsets.
+     * @returns An array of time zone offsets defined in this time zone that are of type STANDARD.
+     */
+    getStandardOffsets(): TimeZoneOffset[];
+    /**
+     * Get daylight savings time offsets.
+     * @returns An array of time zone offsets defined in this time zone that are of type DAYLIGHT.
+     */
+    getDaylightOffsets(): TimeZoneOffset[];
+    /**
+     * @deprecated Use {@link getId} instead.
+     */
+    id: () => string;
+    /**
+     * @deprecated Use {@link getLastModified} instead.
+     */
+    lastMod: () => CalendarDateOrTime | undefined;
+    /**
+     * @deprecated Use {@link setLastModified} instead.
+     */
+    setLastMod: (value: Date) => this;
+    /**
+     * @deprecated Use {@link removeLastModified} instead.
+     */
+    removeLastMod: () => void;
+    /**
+     * @deprecated Use {@link getUrl} instead.
+     */
+    url: () => string | undefined;
+    /**
+     * Get all time offsets.
+     * @returns An array of time zone offsets defined in this time zone.
+     * @deprecated Use {@link getOffsets} instead.
+     */
+    offsets: () => TimeZoneOffset[];
+    /**
+     * Get standard/winter time offsets.
+     * @returns An array of time zone offsets defined in this time zone that are of type STANDARD.
+     * @deprecated Use {@link getStandardOffsets} instead.
+     */
+    standardOffsets: () => TimeZoneOffset[];
+    /**
+     * Get daylight savings time offsets.
+     * @returns An array of time zone offsets defined in this time zone that are of type DAYLIGHT.
+     * @deprecated Use {@link getDaylightOffsets} instead.
+     */
+    daylightOffsets: () => TimeZoneOffset[];
+}
+//# sourceMappingURL=TimeZone.d.ts.map

package/lib/components/TimeZone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeZone.d.ts","sourceRoot":"","sources":["../../src/components/TimeZone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA4B,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAqB,MAAM,SAAS,CAAA;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;GAEG;AACH,qBAAa,QAAS,SAAQ,SAAS;IACnC,IAAI,SAAc;gBAEN,EAAE,EAAE,MAAM;gBACV,SAAS,EAAE,SAAS;IAchC,QAAQ;IAOR,KAAK,IAAI,MAAM;IAIf,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1B,eAAe,IAAI,kBAAkB,GAAG,SAAS;IAMjD,eAAe,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAIlC,kBAAkB;IAIlB,MAAM,IAAI,MAAM,GAAG,SAAS;IAI5B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3B,SAAS;IAIT;;;OAGG;IACH,UAAU,IAAI,cAAc,EAAE;IAa9B;;;OAGG;IACH,kBAAkB,IAAI,cAAc,EAAE;IAMtC;;;OAGG;IACH,kBAAkB,IAAI,cAAc,EAAE;IAQtC;;OAEG;IACH,EAAE,QA5EO,MAAM,CA4EA;IAEf;;OAEG;IACH,OAAO,QAzEY,kBAAkB,GAAG,SAAS,CAyEnB;IAE9B;;OAEG;IACH,UAAU,UAxEa,IAAI,KAAG,IAAI,CAwED;IAEjC;;OAEG;IACH,aAAa,aAA0B;IAEvC;;OAEG;IACH,GAAG,QA1EO,MAAM,GAAG,SAAS,CA0EX;IAEjB;;;;OAIG;IACH,OAAO,QAjEO,cAAc,EAAE,CAiEL;IAEzB;;;;OAIG;IACH,eAAe,QAvDO,cAAc,EAAE,CAuDG;IAEzC;;;;OAIG;IACH,eAAe,QApDO,cAAc,EAAE,CAoDG;CAC5C"}

package/lib/components/TimeZone.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeZone = void 0;
+const component_1 = require("../component");
+const date_1 = require("../date");
+const TimeZoneOffset_1 = require("./TimeZoneOffset");
+/**
+ * Represents a VTIMEZONE component, containing time zone definitions.
+ */
+class TimeZone extends component_1.Component {
+    name = 'VTIMEZONE';
+    constructor(a) {
+        let component;
+        if (a instanceof component_1.Component) {
+            component = a;
+            TimeZone.prototype.validate.call(component);
+        }
+        else {
+            const tzid = a;
+            component = new component_1.Component('VTIMEZONE');
+            component.setProperty('TZID', tzid);
+        }
+        super(component.name, component.properties, component.components);
+    }
+    validate() {
+        if (this.name !== 'VTIMEZONE')
+            throw new component_1.ComponentValidationError('Component name must be VEVENT');
+        const requiredProperties = ['TZID'];
+        this.validateAllProperties(requiredProperties);
+    }
+    getId() {
+        return this.getProperty('TZID').value;
+    }
+    setId(value) {
+        return this.setProperty('TZID', value);
+    }
+    getLastModified() {
+        const text = this.getProperty('LAST-MODIFIED');
+        if (!text)
+            return;
+        return (0, date_1.parseDateProperty)(text);
+    }
+    setLastModified(value) {
+        return this.setProperty('LAST-MODIFIED', value.toISOString());
+    }
+    removeLastModified() {
+        this.removePropertiesWithName('LAST-MOD');
+    }
+    getUrl() {
+        return this.getProperty('TZURL')?.value;
+    }
+    setUrl(value) {
+        return this.setProperty('TZURL', value);
+    }
+    removeUrl() {
+        this.removePropertiesWithName('TZURL');
+    }
+    /**
+     * Get all time offsets.
+     * @returns An array of time zone offsets defined in this time zone.
+     */
+    getOffsets() {
+        const offsets = [];
+        this.components.forEach(component => {
+            if (component.name === 'STANDARD' ||
+                component.name === 'DAYLIGHT') {
+                offsets.push(new TimeZoneOffset_1.TimeZoneOffset(component));
+            }
+        });
+        return offsets;
+    }
+    /**
+     * Get standard/winter time offsets.
+     * @returns An array of time zone offsets defined in this time zone that are of type STANDARD.
+     */
+    getStandardOffsets() {
+        return this.getComponentsWithName('STANDARD').map(c => new TimeZoneOffset_1.TimeZoneOffset(c));
+    }
+    /**
+     * Get daylight savings time offsets.
+     * @returns An array of time zone offsets defined in this time zone that are of type DAYLIGHT.
+     */
+    getDaylightOffsets() {
+        return this.getComponentsWithName('DAYLIGHT').map(c => new TimeZoneOffset_1.TimeZoneOffset(c));
+    }
+    /* eslint-disable */
+    /**
+     * @deprecated Use {@link getId} instead.
+     */
+    id = this.getId;
+    /**
+     * @deprecated Use {@link getLastModified} instead.
+     */
+    lastMod = this.getLastModified;
+    /**
+     * @deprecated Use {@link setLastModified} instead.
+     */
+    setLastMod = this.setLastModified;
+    /**
+     * @deprecated Use {@link removeLastModified} instead.
+     */
+    removeLastMod = this.removeLastModified;
+    /**
+     * @deprecated Use {@link getUrl} instead.
+     */
+    url = this.getUrl;
+    /**
+     * Get all time offsets.
+     * @returns An array of time zone offsets defined in this time zone.
+     * @deprecated Use {@link getOffsets} instead.
+     */
+    offsets = this.getOffsets;
+    /**
+     * Get standard/winter time offsets.
+     * @returns An array of time zone offsets defined in this time zone that are of type STANDARD.
+     * @deprecated Use {@link getStandardOffsets} instead.
+     */
+    standardOffsets = this.getStandardOffsets;
+    /**
+     * Get daylight savings time offsets.
+     * @returns An array of time zone offsets defined in this time zone that are of type DAYLIGHT.
+     * @deprecated Use {@link getDaylightOffsets} instead.
+     */
+    daylightOffsets = this.getDaylightOffsets;
+}
+exports.TimeZone = TimeZone;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVGltZVpvbmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29tcG9uZW50cy9UaW1lWm9uZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSw0Q0FBa0U7QUFDbEUsa0NBQStEO0FBRS9ELHFEQUFpRDtBQUVqRDs7R0FFRztBQUNILE1BQWEsUUFBUyxTQUFRLHFCQUFTO0lBQ25DLElBQUksR0FBRyxXQUFXLENBQUE7SUFJbEIsWUFBWSxDQUFxQjtRQUM3QixJQUFJLFNBQW9CLENBQUE7UUFDeEIsSUFBSSxDQUFDLFlBQVkscUJBQVMsRUFBRSxDQUFDO1lBQ3pCLFNBQVMsR0FBRyxDQUFjLENBQUE7WUFDMUIsUUFBUSxDQUFDLFNBQVMsQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFBO1FBQy9DLENBQUM7YUFBTSxDQUFDO1lBQ0osTUFBTSxJQUFJLEdBQUcsQ0FBVyxDQUFBO1lBQ3hCLFNBQVMsR0FBRyxJQUFJLHFCQUFTLENBQUMsV0FBVyxDQUFDLENBQUE7WUFDdEMsU0FBUyxDQUFDLFdBQVcsQ0FBQyxNQUFNLEVBQUUsSUFBSSxDQUFDLENBQUE7UUFDdkMsQ0FBQztRQUNELEtBQUssQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFLFNBQVMsQ0FBQyxVQUFVLEVBQUUsU0FBUyxDQUFDLFVBQVUsQ0FBQyxDQUFBO0lBQ3JFLENBQUM7SUFFRCxRQUFRO1FBQ0osSUFBSSxJQUFJLENBQUMsSUFBSSxLQUFLLFdBQVc7WUFDekIsTUFBTSxJQUFJLG9DQUF3QixDQUFDLCtCQUErQixDQUFDLENBQUE7UUFDdkUsTUFBTSxrQkFBa0IsR0FBd0IsQ0FBQyxNQUFNLENBQUMsQ0FBQTtRQUN4RCxJQUFJLENBQUMscUJBQXFCLENBQUMsa0JBQWtCLENBQUMsQ0FBQTtJQUNsRCxDQUFDO0lBRUQsS0FBSztRQUNELE9BQU8sSUFBSSxDQUFDLFdBQVcsQ0FBQyxNQUFNLENBQUUsQ0FBQyxLQUFLLENBQUE7SUFDMUMs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

package/lib/components/TimeZoneOffset.d.ts

@@ -0,0 +1,103 @@
+import { Component } from '../component';
+import { CalendarDateOrTime } from '../date';
+export declare const knownOffsetTypes: string[];
+export type OffsetType = (typeof knownOffsetTypes)[number];
+type Digit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
+export type Offset = `${'-' | '+'}${Digit}${Digit}${Digit}${Digit}`;
+/**
+ * Represents a STANDARD or DAYLIGHT subcomponent, defining a time zone offset.
+ */
+export declare class TimeZoneOffset extends Component {
+    /**
+     * @param type If this is a STANDARD or DAYLIGHT component.
+     * @param start From when this offset is active.
+     * @param offsetFrom The offset that is in use prior to this time zone observance.
+     * @param offsetTo The offset that is in use during this time zone observance.
+     */
+    constructor(type: OffsetType, start: CalendarDateOrTime | Date, offsetFrom: Offset, offsetTo: Offset);
+    constructor(component: Component);
+    validate(): void;
+    /**
+     * Get the date or time when this time zone offset starts.
+     * @returns The start date or time of this time zone offset.
+     */
+    getStart(): CalendarDateOrTime;
+    /**
+     * Set the date or time when this time zone offset starts.
+     * @param value The start date or time.
+     * @returns The TimeZoneOffset instance for chaining.
+     */
+    setStart(value: CalendarDateOrTime | Date): this;
+    /**
+     * Get the offset which is offset from during this time zone offset.
+     * @returns The offset in a format such as "+0100" or "-0230".
+     */
+    getOffsetFrom(): Offset;
+    /**
+     * Set the offset to offset from during this time zone offset.
+     * @param value An offset such as "+0100" or "-0230".
+     * @returns The TimeZoneOffset instance for chaining.
+     */
+    setOffsetFrom(value: Offset): this;
+    /**
+     * Get the offset which is offset to during this time zone offset.
+     * @returns The offset in a format such as "+0100" or "-0230".
+     */
+    getOffsetTo(): Offset;
+    /**
+     * Set the offset to offset to during this time zone offset.
+     * @param value An offset such as "+0100" or "-0230".
+     * @returns The TimeZoneOffset instance for chaining.
+     */
+    setOffsetTo(value: Offset): this;
+    getComment(): string | undefined;
+    setComment(value: string): this;
+    removeComment(): void;
+    /**
+     * Get the name of this time zone offset.
+     * @returns The time zone offset name if it exists.
+     */
+    getTimeZoneName(): string | undefined;
+    /**
+     * Set the name of this time zone offset.
+     * @param value The new name.
+     * @returns The TimeZoneOffset instance for chaining.
+     * @example
+     * timeZoneOffset.setTimeZoneName('EST')
+     */
+    setTimeZoneName(value: string): this;
+    /**
+     * Remove the name of this time zone offset.
+     */
+    removeTimeZoneName(): void;
+    /**
+     * Get the date or time when this time zone offset starts.
+     * @returns The start date or time of this time zone offset.
+     * @deprecated Use {@link getStart} instead.
+     */
+    start: () => CalendarDateOrTime;
+    /**
+     * Get the offset which is offset from during this time zone offset.
+     * @returns The offset in a format such as "+0100" or "-0230".
+     * @deprecated Use {@link getOffsetFrom} instead.
+     */
+    offsetFrom: () => Offset;
+    /**
+     * Get the offset which is offset to during this time zone offset.
+     * @returns The offset in a format such as "+0100" or "-0230".
+     * @deprecated Use {@link getOffsetTo} instead.
+     */
+    offsetTo: () => Offset;
+    /**
+     * @deprecated Use {@link getComment} instead.
+     */
+    comment: () => string | undefined;
+    /**
+     * Get the name of this time zone offset.
+     * @returns The time zone offset name if it exists.
+     * @deprecated Use {@link getTimeZoneName} instead.
+     */
+    timeZoneName: () => string | undefined;
+}
+export {};
+//# sourceMappingURL=TimeZoneOffset.d.ts.map

package/lib/components/TimeZoneOffset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeZoneOffset.d.ts","sourceRoot":"","sources":["../../src/components/TimeZoneOffset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA4B,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAkC,MAAM,SAAS,CAAA;AAG5E,eAAO,MAAM,gBAAgB,UAA2B,CAAA;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAC1D,KAAK,KAAK,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;AACtE,MAAM,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,EAAE,CAAA;AAEnE;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS;IACzC;;;;;OAKG;gBAEC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,kBAAkB,GAAG,IAAI,EAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM;gBAER,SAAS,EAAE,SAAS;IAwBhC,QAAQ,IAAI,IAAI;IAchB;;;OAGG;IACH,QAAQ,IAAI,kBAAkB;IAI9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI;IAIhD;;;OAGG;IACH,aAAa,IAAI,MAAM;IAIvB;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlC;;;OAGG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,UAAU,IAAI,MAAM,GAAG,SAAS;IAIhC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B,aAAa;IAIb;;;OAGG;IACH,eAAe,IAAI,MAAM,GAAG,SAAS;IAIrC;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,kBAAkB;IAMlB;;;;OAIG;IACH,KAAK,QA5FO,kBAAkB,CA4FT;IAErB;;;;OAIG;IACH,UAAU,QAlFO,MAAM,CAkFQ;IAE/B;;;;OAIG;IACH,QAAQ,QAxEO,MAAM,CAwEM;IAE3B;;OAEG;IACH,OAAO,QAhEO,MAAM,GAAG,SAAS,CAgEP;IAEzB;;;;OAIG;IACH,YAAY,QAvDO,MAAM,GAAG,SAAS,CAuDF;CACtC"}