iamcal 2.0.0 → 2.1.0

package/README.md

@@ -1,6 +1,6 @@
-# iamcal [![build status](https://img.shields.io/github/actions/workflow/status/olillin/iamcal/npm-test.yml?style=flat-square)](https://github.com/olillin/iamcal/actions/workflows/npm-test.yml) [![npm badge](<https://img.shields.io/npm/v/iamcal?style=flat-square&color=red>)](https://www.npmjs.com/package/iamcal)
+# iamcal [![build status](https://img.shields.io/github/actions/workflow/status/olillin/iamcal/npm-test.yml?style=flat-square)](https://github.com/olillin/iamcal/actions/workflows/npm-test.yml) [![npm badge](https://img.shields.io/npm/v/iamcal?style=flat-square&color=red)](https://www.npmjs.com/package/iamcal)
 
-A library for reading, modifying and writing [ICalendar](https://en.wikipedia.org/wiki/ICalendar) files.
+A library for reading, modifying and writing [iCalendar](https://en.wikipedia.org/wiki/ICalendar) files.
 
 ## Installation
 
@@ -14,12 +14,10 @@ npm install iamcal
 
 ### Parsing and editing a calendar
 
-This code:
+Below is an example of editing a calendar file.
 
 ```typescript
-import { Calendar } from 'iamcal'
-import { dump } from 'iamcal/io'
-import { parseCalendar } from 'iamcal/parse'
+import { Calendar, dump, parseCalendar } from 'iamcal'
 
 const calendar: Calendar = await parseCalendar(`
 BEGIN:VCALENDAR
@@ -36,16 +34,16 @@ END:VEVENT
 END:VCALENDAR
 `)
 
-calendar.events().forEach(event => {
-    if (event.summary() === "🎉iamcal release party") {
-        event.setLocation("My house (budget cuts sorry)")
+calendar.getEvents().forEach(event => {
+    if (event.getSummary() === '🎉iamcal release party') {
+        event.setLocation('My house (budget cuts sorry)')
     }
 })
 
-await dump(calendar, "./new_calendar.ics")
+await dump(calendar, './new_calendar.ics')
 ```
 
-produces the file `new_calendar.ics`:
+Running the code will produce the file `new_calendar.ics`:
 
 ```icalendar
 BEGIN:VCALENDAR
@@ -63,3 +61,41 @@ END:VCALENDAR
 ```
 
 ### Creating a new calendar
+
+Below is an example of creating a new calendar from scratch.
+
+```typescript
+const calendar = new Calendar('example')
+
+const uid = '6c9fabd0-cc8f-4900-b795-40e3d125b233'
+const stamp = new CalendarDateTime('2025-07-06T12:00:00')
+const start = new CalendarDateTime('2025-07-08T17:00:00')
+const end = new CalendarDateTime('2025-07-08T20:00:00')
+
+const event = new CalendarEvent(uid, stamp, start)
+    .setEnd(end)
+    .setSummary('Celebrating my new calendar!')
+    .setDescription('I made it with iamcal')
+
+calendar.addComponent(event)
+
+const calendarText = calendar.serialize()
+console.log(calendarText)
+```
+
+Running the code above will produce the following output:
+
+```icalendar
+BEGIN:VCALENDAR
+PRODID:example
+VERSION:2.0
+BEGIN:VEVENT
+UID:6c9fabd0-cc8f-4900-b795-40e3d125b233
+DTSTAMP:20250706T120000
+DTSTART:20250708T170000
+DTEND:20250708T200000
+SUMMARY:Celebrating my new calendar!
+DESCRIPTION:I made it with iamcal
+END:VEVENT
+END:VCALENDAR
+```

package/lib/component.d.ts

@@ -1,7 +1,8 @@
-export interface Property {
-    name: string;
-    params: string[];
-    value: string;
+import { CalendarDateOrTime } from './date';
+import { AllowedPropertyName, Property } from './property';
+/** Represents an error which occurs while validating a calendar component. */
+export declare class ComponentValidationError extends Error {
+    constructor(message: string);
 }
 export declare class Component {
     name: string;
@@ -10,16 +11,52 @@ export declare class Component {
     constructor(name: string, properties?: Property[], components?: Component[]);
     serialize(): string;
     getProperty(name: string): Property | null;
-    setProperty(name: string, value: string): this;
-    removePropertiesWithName(name: string): this | undefined;
+    setProperty(name: string, value: string | CalendarDateOrTime): this;
+    hasProperty(name: string, value?: string): boolean;
+    removePropertiesWithName(name: string): void;
     getPropertyParams(name: string): string[] | null;
     setPropertyParams(name: string, params: string[]): this;
     addComponent(component: Component): this;
+    addComponents(components: Component[]): this;
     /**
-     * Remove a component from this component
-     * @returns `true` if the component was removed. `false` if the component was not present
+     * Remove a component from this component.
+     * @param component The component to remove.
+     * @returns `true` if the component was removed. `false` if the component was not present.
      */
     removeComponent(component: Component): boolean;
-    getComponents(name: string): Component[];
+    getComponentsWithName(name: string): Component[];
+    /**
+     * Validate the component according to the rules of the iCalendar
+     * specification.
+     *
+     * This method should be overridden by subclasses to
+     * implement specific validation logic. The methods
+     * {@link validateRequiredProperty} and {@link validateOptionalProperty} may
+     * help with this.
+     * @throws {ComponentValidationError} If the component is invalid.
+     */
+    validate(): void;
+    /**
+     * Validate that a property exists and is valid using {@link validateProperty}.
+     * @param propertyName The name of the property to validate.
+     * @throws {MissingPropertyError} If the property doesn't exist on this component.
+     * @throws {PropertyValidationError} If the property exists but is invalid.
+     */
+    validateRequiredProperty(propertyName: AllowedPropertyName): void;
+    /**
+     * Validate that a property is valid using {@link validateProperty} if it exists.
+     * @param propertyName The name of the property to validate.
+     * @throws {PropertyValidationError} If the property exists and is invalid.
+     */
+    validateOptionalProperty(propertyName: AllowedPropertyName): void;
+    /**
+     * Validate all properties on this component.
+     *
+     * If a property is in `requiredProperties` it is
+     * validated with {@link validateRequiredProperty}, otherwise it is
+     * validated with {@link validateOptionalProperty}.
+     * @param requiredProperties A list of property names which are required on this component.
+     */
+    validateAllProperties(requiredProperties?: AllowedPropertyName[]): void;
 }
 //# sourceMappingURL=component.d.ts.map

package/lib/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,SAAS;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,QAAQ,EAAE,CAAA;IACtB,UAAU,EAAE,SAAS,EAAE,CAAA;gBAEX,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,UAAU,CAAC,EAAE,SAAS,EAAE;IAc3E,SAAS,IAAI,MAAM;IA+BnB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAS1C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAe9C,wBAAwB,CAAC,IAAI,EAAE,MAAM;IAOrC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAShD,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IASvD,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAKxC;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAU9C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;CAW3C"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAC3C,OAAO,EACH,mBAAmB,EAGnB,QAAQ,EAGX,MAAM,YAAY,CAAA;AAEnB,8EAA8E;AAC9E,qBAAa,wBAAyB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI9B;AAKD,qBAAa,SAAS;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,QAAQ,EAAE,CAAA;IACtB,UAAU,EAAE,SAAS,EAAE,CAAA;gBAGnB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,QAAQ,EAAE,EACvB,UAAU,CAAC,EAAE,SAAS,EAAE;IAe5B,SAAS,IAAI,MAAM;IA+BnB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAS1C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAyBnE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAYlD,wBAAwB,CAAC,IAAI,EAAE,MAAM;IAOrC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAShD,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IASvD,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAKxC,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI;IAK5C;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAU9C,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IAYhD;;;;;;;;;OASG;IACH,QAAQ,IAAI,IAAI;IAEhB;;;;;OAKG;IACH,wBAAwB,CAAC,YAAY,EAAE,mBAAmB;IAS1D;;;;OAIG;IACH,wBAAwB,CAAC,YAAY,EAAE,mBAAmB;IAK1D;;;;;;;OAOG;IACH,qBAAqB,CAAC,kBAAkB,CAAC,EAAE,mBAAmB,EAAE;CAmBnE"}

package/lib/component.js

@@ -1,6 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Component = void 0;
+exports.Component = exports.ComponentValidationError = void 0;
+const property_1 = require("./property");
+/** Represents an error which occurs while validating a calendar component. */
+class ComponentValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ComponentValidationError';
+    }
+}
+exports.ComponentValidationError = ComponentValidationError;
 // Max line length as defined by RFC 5545 3.1.
 const MAX_LINE_LENGTH = 75;
 class Component {
@@ -13,19 +22,19 @@ class Component {
             this.properties = properties;
         }
         else {
-            this.properties = new Array();
+            this.properties = [];
         }
         if (components) {
             this.components = components;
         }
         else {
-            this.components = new Array();
+            this.components = [];
         }
     }
     serialize() {
         // Create lines
         const lines = [`BEGIN:${this.name}`];
-        for (let property of this.properties) {
+        for (const property of this.properties) {
             let line = property['name'] + //
                 property.params.map(p => ';' + p).join('') +
                 ':' +
@@ -37,7 +46,7 @@ class Component {
             }
             lines.push(line);
         }
-        for (let component of this.components) {
+        for (const component of this.components) {
             lines.push(component.serialize());
         }
         lines.push(`END:${this.name}`);
@@ -56,21 +65,39 @@ class Component {
     setProperty(name, value) {
         for (const property of this.properties) {
             if (property.name === name) {
-                property.value = value;
+                if (typeof value === 'string') {
+                    property.value = value;
+                }
+                else {
+                    const prop = value.toProperty(name);
+                    property.params = prop.params;
+                    property.value = prop.value;
+                }
                 return this;
             }
         }
-        this.properties.push({
-            name: name,
-            params: [],
-            value: value,
-        });
+        this.properties.push(typeof value === 'string'
+            ? {
+                name: name,
+                params: [],
+                value: value,
+            }
+            : value.toProperty(name));
         return this;
     }
+    hasProperty(name, value) {
+        for (const property of this.properties) {
+            if (property.name === name &&
+                (value === undefined || property.value === value)) {
+                return true;
+            }
+        }
+        return false;
+    }
     removePropertiesWithName(name) {
         const index = this.properties.findIndex(p => p.name === name);
         if (index === -1)
-            return this;
+            return;
         // Remove property at index
         this.properties.splice(index, 1);
     }
@@ -94,9 +121,14 @@ class Component {
         this.components.push(component);
         return this;
     }
+    addComponents(components) {
+        this.components.push(...components);
+        return this;
+    }
     /**
-     * Remove a component from this component
-     * @returns `true` if the component was removed. `false` if the component was not present
+     * Remove a component from this component.
+     * @param component The component to remove.
+     * @returns `true` if the component was removed. `false` if the component was not present.
      */
     removeComponent(component) {
         const index = this.components.indexOf(component);
@@ -106,15 +138,71 @@ class Component {
         this.components.splice(index, 1);
         return true;
     }
-    getComponents(name) {
+    getComponentsWithName(name) {
         const components = [];
-        for (let component of this.components) {
+        for (const component of this.components) {
             if (component.name === name) {
                 components.push(component);
             }
         }
         return components;
     }
+    /**
+     * Validate the component according to the rules of the iCalendar
+     * specification.
+     *
+     * This method should be overridden by subclasses to
+     * implement specific validation logic. The methods
+     * {@link validateRequiredProperty} and {@link validateOptionalProperty} may
+     * help with this.
+     * @throws {ComponentValidationError} If the component is invalid.
+     */
+    validate() { }
+    /**
+     * Validate that a property exists and is valid using {@link validateProperty}.
+     * @param propertyName The name of the property to validate.
+     * @throws {MissingPropertyError} If the property doesn't exist on this component.
+     * @throws {PropertyValidationError} If the property exists but is invalid.
+     */
+    validateRequiredProperty(propertyName) {
+        const property = this.getProperty(propertyName);
+        if (property == null)
+            throw new property_1.MissingPropertyError(`Missing required property ${propertyName}`);
+        (0, property_1.validateProperty)(property);
+    }
+    /**
+     * Validate that a property is valid using {@link validateProperty} if it exists.
+     * @param propertyName The name of the property to validate.
+     * @throws {PropertyValidationError} If the property exists and is invalid.
+     */
+    validateOptionalProperty(propertyName) {
+        const property = this.getProperty(propertyName);
+        if (property != null)
+            (0, property_1.validateProperty)(property);
+    }
+    /**
+     * Validate all properties on this component.
+     *
+     * If a property is in `requiredProperties` it is
+     * validated with {@link validateRequiredProperty}, otherwise it is
+     * validated with {@link validateOptionalProperty}.
+     * @param requiredProperties A list of property names which are required on this component.
+     */
+    validateAllProperties(requiredProperties) {
+        requiredProperties?.forEach(propertyName => {
+            if (!this.hasProperty(propertyName)) {
+                throw new property_1.MissingPropertyError(`Missing required property ${propertyName}`);
+            }
+        });
+        this.properties.forEach(property => {
+            if (requiredProperties?.includes(property.name)) {
+                this.validateRequiredProperty(property.name);
+            }
+            else {
+                this.validateOptionalProperty(property.name);
+            }
+        });
+    }
 }
 exports.Component = Component;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tcG9uZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbXBvbmVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSw4Q0FBOEM7QUFDOUMsTUFBTSxlQUFlLEdBQUcsRUFBRSxDQUFBO0FBUTFCLE1BQWEsU0FBUztJQUNsQixJQUFJLENBQVE7SUFDWixVQUFVLENBQVk7SUFDdEIsVUFBVSxDQUFhO0lBRXZCLFlBQVksSUFBWSxFQUFFLFVBQXVCLEVBQUUsVUFBd0I7UUFDdkUsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUE7UUFDaEIsSUFBSSxVQUFVLEVBQUUsQ0FBQztZQUNiLElBQUksQ0FBQyxVQUFVLEdBQUcsVUFBVSxDQUFBO1FBQ2hDLENBQUM7YUFBTSxDQUFDO1lBQ0osSUFBSSxDQUFDLFVBQVUsR0FBRyxJQUFJLEtBQUssRUFBRSxDQUFBO1FBQ2pDLENBQUM7UUFDRCxJQUFJLFVBQVUsRUFBRSxDQUFDO1lBQ2IsSUFBSSxDQUFDLFVBQVUsR0FBRyxVQUFVLENBQUE7UUFDaEMsQ0FBQzthQUFNLENBQUM7WUFDSixJQUFJLENBQUMsVUFBVSxHQUFHLElBQUksS0FBSyxFQUFFLENBQUE7UUFDakMsQ0FBQztJQUNMLENBQUM7SUFFRCxTQUFTO1FBQ0wsZUFBZTtRQUNmLE1BQU0sS0FBSyxHQUFHLENBQUMsU0FBUyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQTtRQUVwQyxLQUFLLElBQUksUUFBUSxJQUFJLElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQztZQUNuQyxJQUFJLElBQUksR0FDSixRQUFRLENBQUMsTUFBTSxDQUFDLEdBQUcsRUFBRTtnQkFDckIsUUFBUSxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxHQUFHLEdBQUcsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztnQkFDMUMsR0FBRztnQkFDSCxRQUFRLENBQUMsT0FBTyxDQUFDLENB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29tcG9uZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2NvbXBvbmVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFDQSx5Q0FPbUI7QUFFbkIsOEVBQThFO0FBQzlFLE1BQWEsd0JBQXlCLFNBQVEsS0FBSztJQUMvQyxZQUFZLE9BQWU7UUFDdkIsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFBO1FBQ2QsSUFBSSxDQUFDLElBQUksR0FBRywwQkFBMEIsQ0FBQTtJQUMxQyxDQUFDO0NBQ0o7QUFMRCw0REFLQztBQUVELDhDQUE4QztBQUM5QyxNQUFNLGVBQWUsR0FBRyxFQUFFLENBQUE7QUFFMUIsTUFBYSxTQUFTO0lBQ2xCLElBQUksQ0FBUTtJQUNaLFVBQVUsQ0FBWTtJQUN0QixVQUFVLENBQWE7SUFFdkIsWUFDSSxJQUFZLEVBQ1osVUFBdUIsRUFDdkIsVUFBd0I7UUFFeEIsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUE7UUFDaEIsSUFBSSxVQUFVLEVBQUUsQ0FBQztZQUNiLElBQUksQ0FBQyxVQUFVLEdBQUcsVUFBVSxDQUFBO1FBQ2hDLENBQUM7YUFBTSxDQUFDO1lBQ0osSUFBSSxDQUFDLFVBQVUsR0FBRyxFQUFFLENBQUE7UUFDeEIsQ0FBQztRQUNELElBQUksVUFBVSxFQUFFLENBQUM7WUFDYixJQUFJLENBQUMsVUFBVSxHQUFHLFVBQVUsQ0FBQTtRQUNoQyxDQUFDO2FBQU0sQ0FBQztZQUNKLElBQUksQ0FBQyxVQUFVLEdBQUcsRUFBRSxDQUFBO1FBQ3hCLENBQUM7SUFDTCxDQUFDO0lBRUQsU0FBUztRQUNMLGVBQWU7UUFDZixNQUFNLEtBQUssR0FBRyxDQUFDLFNBQVMsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDLENBQUE7UUFFcEMsS0FBSyxNQUFNLFFBQVEsSUFBSSxJQUFJLENBQUMsVUFBVSxFQUFFLENBQUM7WUFDckMsSUFBSSxJQUFJLEdBQ0osUUFBUSxDQUFDLE1BQU0sQ0FBQyxHQUFHLEVB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

package/lib/components/Calendar.d.ts

@@ -7,39 +7,60 @@ export declare class Calendar extends Component {
     name: string;
     /**
      * @param prodid A unique identifier of the program creating the calendar.
-     *
-     * Example: `-//Google Inc//Google Calendar 70.9054//EN`
+     * @example
+     * new Calendar('-//Google Inc//Google Calendar 70.9054//EN')
      */
     constructor(prodid: string);
     /**
      * @param prodid A unique identifier of the program creating the calendar.
-     *
-     * Example: `-//Google Inc//Google Calendar 70.9054//EN`
      * @param version The version of the iCalendar specification that this calendar uses.
+     * @example
+     * new Calendar('-//Google Inc//Google Calendar 70.9054//EN')
      */
     constructor(prodid: string, version: string);
     /**
      * @param component A VCALENDAR component.
      */
     constructor(component: Component);
-    events(): CalendarEvent[];
+    validate(): void;
+    getEvents(): CalendarEvent[];
     removeEvent(event: CalendarEvent): boolean;
     removeEvent(uid: string): boolean;
-    prodId(): string;
-    setProdId(value: string): this;
-    version(): string;
+    getProductId(): string;
+    setProductId(value: string): this;
+    getVersion(): string;
     setVersion(value: string): this;
-    calScale(): string | undefined;
-    setCalScale(value: string): this;
-    removeCalScale(): void;
-    method(): string | undefined;
+    getCalendarScale(): string | undefined;
+    setCalendarScale(value: string): this;
+    removeCalendarScale(): void;
+    getMethod(): string | undefined;
     setMethod(value: string): this;
     removeMethod(): void;
-    calendarName(): string | undefined;
+    getCalendarName(): string | undefined;
     setCalendarName(value: string): this;
     removeCalendarName(): void;
-    calendarDescription(): string | undefined;
+    getCalendarDescription(): string | undefined;
     setCalendarDescription(value: string): this;
     removeCalendarDescription(): void;
+    /** @deprecated use {@link getEvents} instead */
+    events: () => CalendarEvent[];
+    /** @deprecated use {@link getProductId} instead */
+    prodId: () => string;
+    /** @deprecated use {@link setProductId} instead */
+    setProdId: (value: string) => this;
+    /** @deprecated use {@link getVersion} instead */
+    version: () => string;
+    /** @deprecated use {@link getCalendarScale} instead */
+    calScale: () => string | undefined;
+    /** @deprecated use {@link setCalendarScale} instead */
+    setCalScale: (value: string) => this;
+    /** @deprecated use {@link removeCalendarScale} instead */
+    removeCalScale: () => void;
+    /** @deprecated use {@link getMethod} instead */
+    method: () => string | undefined;
+    /** @deprecated use {@link getCalendarName} instead */
+    calendarName: () => string | undefined;
+    /** @deprecated use {@link getCalendarDescription} instead */
+    calendarDescription: () => string | undefined;
 }
 //# sourceMappingURL=Calendar.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Calendar.d.ts","sourceRoot":"","sources":["../../src/components/Calendar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;GAEG;AACH,qBAAa,QAAS,SAAQ,SAAS;IACnC,IAAI,SAAe;IAEnB;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAC1B;;;;;OAKG;gBACS,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAC3C;;OAEG;gBACS,SAAS,EAAE,SAAS;IAehC,MAAM,IAAI,aAAa,EAAE;IAIzB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAC1C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAejC,MAAM,IAAI,MAAM;IAIhB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,IAAI,MAAM;IAIjB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhC,cAAc;IAId,MAAM,IAAI,MAAM,GAAG,SAAS;IAI5B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,YAAY;IAIZ,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,kBAAkB;IAIlB,mBAAmB,IAAI,MAAM,GAAG,SAAS;IAIzC,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3C,yBAAyB;CAG5B"}
+{"version":3,"file":"Calendar.d.ts","sourceRoot":"","sources":["../../src/components/Calendar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAA4B,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;GAEG;AACH,qBAAa,QAAS,SAAQ,SAAS;IACnC,IAAI,SAAc;IAElB;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAE1B;;;;;OAKG;gBACS,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAE3C;;OAEG;gBACS,SAAS,EAAE,SAAS;IAgBhC,QAAQ;IASR,SAAS,IAAI,aAAa,EAAE;IAM5B,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAC1C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAejC,YAAY,IAAI,MAAM;IAItB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIjC,UAAU,IAAI,MAAM;IAIpB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/B,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC,mBAAmB;IAInB,SAAS,IAAI,MAAM,GAAG,SAAS;IAI/B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,YAAY;IAIZ,eAAe,IAAI,MAAM,GAAG,SAAS;IAIrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,kBAAkB;IAIlB,sBAAsB,IAAI,MAAM,GAAG,SAAS;IAI5C,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3C,yBAAyB;IAMzB,gDAAgD;IAChD,MAAM,QAzFO,aAAa,EAAE,CAyFL;IACvB,mDAAmD;IACnD,MAAM,QArEU,MAAM,CAqEI;IAC1B,mDAAmD;IACnD,SAAS,UAnEW,MAAM,KAAG,IAAI,CAmEJ;IAC7B,iDAAiD;IACjD,OAAO,QAjEO,MAAM,CAiEK;IACzB,uDAAuD;IACvD,QAAQ,QA3DY,MAAM,GAAG,SAAS,CA2DN;IAChC,uDAAuD;IACvD,WAAW,UAzDa,MAAM,KAAG,IAAI,CAyDF;IACnC,0DAA0D;IAC1D,cAAc,aAA2B;IACzC,gDAAgD;IAChD,MAAM,QArDO,MAAM,GAAG,SAAS,CAqDR;IACvB,sDAAsD;IACtD,YAAY,QA3CO,MAAM,GAAG,SAAS,CA2CF;IACnC,6DAA6D;IAC7D,mBAAmB,QAjCO,MAAM,GAAG,SAAS,CAiCK;CACpD"}

package/lib/components/Calendar.js

@@ -9,9 +9,10 @@ const CalendarEvent_1 = require("./CalendarEvent");
 class Calendar extends component_1.Component {
     name = 'VCALENDAR';
     constructor(a, b) {
-        var component;
+        let component;
         if (a instanceof component_1.Component) {
             component = a;
+            Calendar.prototype.validate.call(component);
         }
         else {
             const prodid = a;
@@ -22,8 +23,14 @@ class Calendar extends component_1.Component {
         }
         super(component.name, component.properties, component.components);
     }
-    events() {
-        return this.getComponents('VEVENT').map(c => new CalendarEvent_1.CalendarEvent(c));
+    validate() {
+        if (this.name !== 'VCALENDAR')
+            throw new component_1.ComponentValidationError('Component name must be VCALENDAR');
+        const requiredProperties = ['PRODID', 'VERSION'];
+        this.validateAllProperties(requiredProperties);
+    }
+    getEvents() {
+        return this.getComponentsWithName('VEVENT').map(c => new CalendarEvent_1.CalendarEvent(c));
     }
     removeEvent(a) {
         if (a instanceof CalendarEvent_1.CalendarEvent) {
@@ -32,36 +39,36 @@ class Calendar extends component_1.Component {
         }
         else {
             const uid = a;
-            for (const event of this.events()) {
-                if (event.uid() !== uid)
+            for (const event of this.getEvents()) {
+                if (event.getUid() !== uid)
                     continue;
                 return this.removeComponent(event);
             }
         }
         return false;
     }
-    prodId() {
+    getProductId() {
         return this.getProperty('PRODID').value;
     }
-    setProdId(value) {
+    setProductId(value) {
         return this.setProperty('PRODID', value);
     }
-    version() {
+    getVersion() {
         return this.getProperty('VERSION').value;
     }
     setVersion(value) {
         return this.setProperty('VERSION', value);
     }
-    calScale() {
+    getCalendarScale() {
         return this.getProperty('CALSCALE')?.value;
     }
-    setCalScale(value) {
+    setCalendarScale(value) {
         return this.setProperty('CALSCALE', value);
     }
-    removeCalScale() {
+    removeCalendarScale() {
         this.removePropertiesWithName('CALSCALE');
     }
-    method() {
+    getMethod() {
         return this.getProperty('METHOD')?.value;
     }
     setMethod(value) {
@@ -70,7 +77,7 @@ class Calendar extends component_1.Component {
     removeMethod() {
         this.removePropertiesWithName('METHOD');
     }
-    calendarName() {
+    getCalendarName() {
         return this.getProperty('X-WR-CALNAME')?.value;
     }
     setCalendarName(value) {
@@ -79,7 +86,7 @@ class Calendar extends component_1.Component {
     removeCalendarName() {
         this.removePropertiesWithName('X-WR-CALNAME');
     }
-    calendarDescription() {
+    getCalendarDescription() {
         return this.getProperty('X-WR-CALDESC')?.value;
     }
     setCalendarDescription(value) {
@@ -88,6 +95,27 @@ class Calendar extends component_1.Component {
     removeCalendarDescription() {
         this.removePropertiesWithName('X-WR-CALDESC');
     }
+    /* eslint-disable */
+    /** @deprecated use {@link getEvents} instead */
+    events = this.getEvents;
+    /** @deprecated use {@link getProductId} instead */
+    prodId = this.getProductId;
+    /** @deprecated use {@link setProductId} instead */
+    setProdId = this.setProductId;
+    /** @deprecated use {@link getVersion} instead */
+    version = this.getVersion;
+    /** @deprecated use {@link getCalendarScale} instead */
+    calScale = this.getCalendarScale;
+    /** @deprecated use {@link setCalendarScale} instead */
+    setCalScale = this.setCalendarScale;
+    /** @deprecated use {@link removeCalendarScale} instead */
+    removeCalScale = this.removeCalendarScale;
+    /** @deprecated use {@link getMethod} instead */
+    method = this.getMethod;
+    /** @deprecated use {@link getCalendarName} instead */
+    calendarName = this.getCalendarName;
+    /** @deprecated use {@link getCalendarDescription} instead */
+    calendarDescription = this.getCalendarDescription;
 }
 exports.Calendar = Calendar;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ2FsZW5kYXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29tcG9uZW50cy9DYWxlbmRhci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSw0Q0FBd0M7QUFDeEMsbURBQStDO0FBRS9DOztHQUVHO0FBQ0gsTUFBYSxRQUFTLFNBQVEscUJBQVM7SUFDbkMsSUFBSSxHQUFHLFdBQVcsQ0FBQztJQW1CbkIsWUFBWSxDQUFzQixFQUFFLENBQVU7UUFDMUMsSUFBSSxTQUFvQixDQUFBO1FBQ3hCLElBQUksQ0FBQyxZQUFZLHFCQUFTLEVBQUUsQ0FBQztZQUN6QixTQUFTLEdBQUcsQ0FBYyxDQUFBO1FBQzlCLENBQUM7YUFBTSxDQUFDO1lBQ0osTUFBTSxNQUFNLEdBQUcsQ0FBVyxDQUFBO1lBQzFCLE1BQU0sT0FBTyxHQUFJLENBQVksSUFBSSxLQUFLLENBQUE7WUFDdEMsU0FBUyxHQUFHLElBQUkscUJBQVMsQ0FBQyxXQUFXLENBQUMsQ0FBQTtZQUN0QyxTQUFTLENBQUMsV0FBVyxDQUFDLFFBQVEsRUFBRSxNQUFNLENBQUMsQ0FBQTtZQUN2QyxTQUFTLENBQUMsV0FBVyxDQUFDLFNBQVMsRUFBRSxPQUFPLENBQUMsQ0FBQTtRQUM3QyxDQUFDO1FBQ0QsS0FBSyxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUUsU0FBUyxDQUFDLFVBQVUsRUFBRSxTQUFTLENBQUMsVUFBVSxDQUFDLENBQUE7SUFDckUsQ0FBQztJQUVELE1BQU07UUFDRixPQUFPLElBQUksQ0FBQyxhQUFhLENBQUMsUUFBUSxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsSUFBSSw2QkFBYSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUE7SUFDdEUsQ0FBQztJQUlELFdBQVcsQ0FBQyxDQUF5QjtRQUNqQyxJQUFJLENBQUMsWUFBWSw2QkFBYSxFQUFFLENBQUM7WUFDN0IsTUFBTSxLQUFLLEdBQUcsQ0FBa0IsQ0FBQTtZQUNoQyxPQUFP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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ2FsZW5kYXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29tcG9uZW50cy9DYWxlbmRhci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFDQSw0Q0FBa0U7QUFDbEUsbURBQStDO0FBRS9DOztHQUVHO0FBQ0gsTUFBYSxRQUFTLFNBQVEscUJBQVM7SUFDbkMsSUFBSSxHQUFHLFdBQVcsQ0FBQTtJQXFCbEIsWUFBWSxDQUFzQixFQUFFLENBQVU7UUFDMUMsSUFBSSxTQUFvQixDQUFBO1FBQ3hCLElBQUksQ0FBQyxZQUFZLHFCQUFTLEVBQUUsQ0FBQztZQUN6QixTQUFTLEdBQUcsQ0FBYyxDQUFBO1lBQzFCLFFBQVEsQ0FBQyxTQUFTLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQTtRQUMvQyxDQUFDO2FBQU0sQ0FBQztZQUNKLE1BQU0sTUFBTSxHQUFHLENBQVcsQ0FBQTtZQUMxQixNQUFNLE9BQU8sR0FBSSxDQUFZLElBQUksS0FBSyxDQUFBO1lBQ3RDLFNBQVMsR0FBRyxJQUFJLHFCQUFTLENBQUMsV0FBVyxDQUFDLENBQUE7WUFDdEMsU0FBUyxDQUFDLFdBQVcsQ0FBQyxRQUFRLEVBQUUsTUFBTSxDQUFDLENBQUE7WUFDdkMsU0FBUyxDQUFDLFdBQVcsQ0FBQyxTQUFTLEVBQUUsT0FBTyxDQUFDLENBQUE7UUFDN0MsQ0FBQztRQUNELEtBQUssQ0FBQyxTQUFTLENBQUMsSUFBSSxFQUFFLFNBQVMsQ0FBQyxVQUFVLEVBQUUsU0FBUyxDQUFDLFVBQVUsQ0FBQyxDQUFBO0lBQ3JFLENBQUM7SUFFRCxRQUFRO1FBQ0osSUFBSSxJQUFJLENBQUMsSUFBSSxLQUFLLFdBQVc7WUFDekIsTUFBTSxJQUFJLG9DQUF3QixDQUM5QixrQ0FBa0MsQ0FDckMsQ0FBQTtRQUNMLE1BQU0sa0JBQWtCLEdBQXdCLENBQUMsUUFBUSxFQUFFLFNBQVMsQ0FBQyxDQUFBO1FBQ3JFLElBQUksQ0FBQyxxQkFBcUIsQ0FB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