iamcal 2.0.0 → 2.1.0

package/lib/parse.js

@@ -4,37 +4,38 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeserializationError = void 0;
+exports.deserializeComponent = deserializeComponent;
 exports.deserialize = deserialize;
+exports.deserializeComponentString = deserializeComponentString;
 exports.deserializeString = deserializeString;
 exports.parseCalendar = parseCalendar;
 exports.parseEvent = parseEvent;
-exports.parseDate = parseDate;
-exports.toTimeString = toTimeString;
-exports.toDateString = toDateString;
-exports.toDateTimeString = toDateTimeString;
-const component_1 = require("./component");
 const readline_1 = __importDefault(require("readline"));
 const stream_1 = require("stream");
+const component_1 = require("./component");
 const components_1 = require("./components");
+/** Represents an error that occurs when deserializing a calendar component. */
 class DeserializationError extends Error {
     name = 'DeserializationError';
 }
 exports.DeserializationError = DeserializationError;
 /**
- * Deserialize a calendar component
- * @param lines the serialized component as a readline interface
+ * Deserialize a calendar component.
+ * @param lines The serialized component as a **readline** interface.
+ * @returns The deserialized calendar component object.
+ * @throws {DeserializationError} If the component is invalid.
  */
-async function deserialize(lines) {
+async function deserializeComponent(lines) {
     const component = new component_1.Component('');
     let done = false;
     // We use a stack to keep track of nested components
     const stack = new Array();
     const subcomponentLines = new Array();
-    async function processLine(line) {
+    const processLine = async (line) => {
         if (line.trim() === '')
             return;
         if (done) {
-            throw new DeserializationError('Trailing data after component end');
+            throw new DeserializationError('Found trailing data after component end');
         }
         if (line.startsWith('BEGIN:')) {
             // Begin component
@@ -50,7 +51,7 @@ async function deserialize(lines) {
         else if (line.startsWith('END:')) {
             // End component
             if (stack.length == 0) {
-                throw new DeserializationError('Component end before begin');
+                throw new DeserializationError('Unexpected component end outside of components');
             }
             const stackName = stack.pop();
             const name = line.slice(line.indexOf(':') + 1);
@@ -60,7 +61,7 @@ async function deserialize(lines) {
             // Check the length of the stack after being popped
             if (stack.length == 1) {
                 subcomponentLines.push(line);
-                const subcomponent = await deserializeString(subcomponentLines.join('\r\n'));
+                const subcomponent = await deserializeComponentString(subcomponentLines.join('\r\n'));
                 subcomponentLines.length = 0;
                 component.components.push(subcomponent);
             }
@@ -73,7 +74,7 @@ async function deserialize(lines) {
         }
         else {
             if (stack.length == 0)
-                throw new DeserializationError('Property outside of components');
+                throw new DeserializationError('Found stray property outside of components');
             if (stack.length > 1) {
                 // Line of subcomponent
                 subcomponentLines.push(line);
@@ -95,7 +96,7 @@ async function deserialize(lines) {
                 component.properties.push(property);
             }
         }
-    }
+    };
     /*
     The following code unfolds lines and passes them to be processed above.
 
@@ -132,59 +133,60 @@ async function deserialize(lines) {
     await processLine(unfoldedLine);
     // Check that component has been closed
     if (!done) {
-        throw new DeserializationError('No component end');
+        throw new DeserializationError('Component has no end');
     }
     return component;
 }
 /**
- * Deserialize a calendar component
- * @param text the serialized component
+ * Deserialize a calendar component.
+ * @param lines The serialized component as a **readline** interface.
+ * @returns The deserialized calendar component object.
+ * @throws {DeserializationError} If the component is invalid.
+ * @deprecated Use {@link deserializeComponent} instead.
  */
-async function deserializeString(text) {
+async function deserialize(lines) {
+    return deserializeComponent(lines);
+}
+/**
+ * Deserialize a calendar component string.
+ * @param text The serialized component.
+ * @returns The deserialized component object.
+ * @throws {DeserializationError} If the component is invalid.
+ */
+async function deserializeComponentString(text) {
     const stream = stream_1.Readable.from(text);
-    const lines = readline_1.default.createInterface({ input: stream, crlfDelay: Infinity });
-    return deserialize(lines);
+    const lines = readline_1.default.createInterface({
+        input: stream,
+        crlfDelay: Infinity,
+    });
+    return deserializeComponent(lines);
 }
 /**
- * Parse a calendar in ICalendar format
- * @param text the serialized calendar
- * @returns the parsed calendar
+ * Deserialize a calendar component string.
+ * @param text The serialized component.
+ * @returns The deserialized component object.
+ * @throws {DeserializationError} If the component is invalid.
+ * @deprecated Use {@link deserializeComponentString} instead.
+ */
+async function deserializeString(text) {
+    return deserializeComponentString(text);
+}
+/**
+ * Parse a serialized calendar.
+ * @param text A serialized calendar as you would see in an iCalendar file.
+ * @returns The parsed calendar object.
  */
 async function parseCalendar(text) {
-    const component = await deserializeString(text);
-    if (component.name !== "VCALENDAR")
-        throw new DeserializationError("Not a calendar");
+    const component = await deserializeComponentString(text);
     return new components_1.Calendar(component);
 }
 /**
- * Parse an event in ICalendar format
- * @param text the serialized event
- * @returns the parsed event
+ * Parse a serialized calendar event.
+ * @param text A serialized event as you would see in an iCalendar file.
+ * @returns The parsed event object.
  */
 async function parseEvent(text) {
-    const component = await deserializeString(text);
-    if (component.name !== "VEVENT")
-        throw new DeserializationError("Not an event");
+    const component = await deserializeComponentString(text);
     return new components_1.CalendarEvent(component);
 }
-function parseDate(dateProperty) {
-    const value = dateProperty.value.trim();
-    if (dateProperty.params.includes('VALUE=DATE')) {
-        // Parse date only
-        return new Date(`${value.substring(0, 4)}-${value.substring(4, 6)}-${value.substring(6, 8)}`);
-    }
-    else {
-        // Parse date and time
-        return new Date(`${value.substring(0, 4)}-${value.substring(4, 6)}-${value.substring(6, 8)} ${value.substring(9, 11)}:${value.substring(11, 13)}:${value.substring(13, 15)}`);
-    }
-}
-function toTimeString(date) {
-    return `${date.getHours().toString().padStart(2, '0')}${date.getMinutes().toString().padStart(2, '0')}${date.getSeconds().toString().padStart(2, '0')}`;
-}
-function toDateString(date) {
-    return `${date.getFullYear().toString().padStart(4, '0')}${date.getMonth().toString().padStart(2, '0')}${date.getDate().toString().padStart(2, '0')}`;
-}
-function toDateTimeString(date) {
-    return `${toDateString(date)}T${toTimeString(date)}`;
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGFyc2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvcGFyc2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBYUEsa0NBc0hDO0FBTUQsOENBSUM7QUFPRCxzQ0FLQztBQU9ELGdDQUtDO0FBRUQsOEJBU0M7QUFFRCxvQ0FFQztBQUVELG9DQUVDO0FBRUQsNENBRUM7QUE1TEQsMkNBQWlEO0FBQ2pELHdEQUErQjtBQUMvQixtQ0FBaUM7QUFDakMsNkNBQXNEO0FBRXRELE1BQWEsb0JBQXFCLFNBQVEsS0FBSztJQUMzQyxJQUFJLEdBQUcsc0JBQXNCLENBQUE7Q0FDaEM7QUFGRCxvREFFQztBQUVEOzs7R0FHRztBQUNJLEtBQUssVUFBVSxXQUFXLENBQUMsS0FBeUI7SUFDdkQsTUFBTSxTQUFTLEdBQUcsSUFBSSxxQkFBUyxDQUFDLEVBQUUsQ0FBQyxDQUFBO0lBQ25DLElBQUksSUFBSSxHQUFHLEtBQUssQ0FBQTtJQUVoQixvREFBb0Q7SUFDcEQsTUFBTSxLQUFLLEdBQUcsSUFBSSxLQUFLLEVBQVUsQ0FBQTtJQUVqQyxNQUFNLGlCQUFpQixHQUFHLElBQUksS0FBSyxFQUFVLENBQUE7SUFFN0MsS0FBSyxVQUFVLFdBQVcsQ0FBQyxJQUFZO1FBQ25DLElBQUksSUFBSSxDQUFDLElBQUksRUFBRSxLQUFLLEVBQUU7WUFBRSxPQUFNO1FBRTlCLElBQUksSUFBSSxFQUFFLENBQUM7WUFDUCxNQUFNLElBQUksb0JBQW9CLENBQUMsbUNBQW1DLENBQUMsQ0FBQTtRQUN2RSxDQUFDO1FBRUQsSUFBSSxJQUFJLENBQUMsVUFBVSxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUM7WUFDNUIsa0JBQWtCO1lBQ2xCLE1BQU0sSUFBSSxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQTtZQUM5QyxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFBO1lBRWhCLElBQUksS0FBSyxDQUFDLE1BQU0sSUFBSSxDQUFDLEVBQUUsQ0FBQztnQkFDcEIsU0FBUyxDQUFDLElBQUksR0FBRyxJQUFJLENBQUE7WUFDekIsQ0FBQztpQkFBTSxDQUFDO2dCQUNKLGlCQUFpQixDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQTtZQUNoQyxDQUFDO1FBQ0wsQ0FBQzthQUFNLElBQUksSUFBSSxDQUFDLFVBQVUsQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO1lBQ2pDLGdCQUFnQjtZQUNoQixJQUFJLEtBQUssQ0FBQyxNQUFNLElBQUksQ0FBQyxFQUFFLENBQUM7Z0JBQ3BCLE1BQU0sSUFBSSxvQkFBb0IsQ0FBQyw0QkFBNEIsQ0FBQyxDQUFBO1lBQ2hFLENBQUM7WUFFRCxNQUFNLFNBQVMsR0FBRyxLQUFLLENBQUMsR0FBRyxFQUFFLENBQUE7WUFDN0IsTUFBTSxJQUFJLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFBO1lBQzlDLElBQUksU0FBUyxLQUFLLElBQUksRUFBRSxDQUFDO2dCQUNyQixNQUFNLElBQUksb0JBQW9CLENBQUMsd0JBQXdCLENBQUMsQ0FBQTtZQUM1RCxDQUFDO1lBRUQsbURBQW1EO1lBQ25ELElBQUksS0FBSyxDQUFDLE1BQU0sSUFBSSxDQUFDLEVBQUUsQ0FBQztnQkFDcEIsaUJBQWlCLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFBO2dCQUM1QixNQUFNLFlBQVksR0FBRyxNQUFNLGlCQUFpQixDQUFDLGlCQUFpQixDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFBO2dCQUM1RSxpQkFBaUIsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFBO2dCQUU1QixTQUFTLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxZQUFZLENBQUMsQ0FBQTtZQUMzQyxDQUFDO2lCQUFNLElBQUksS0FBSyxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztnQkFDMUIsaUJBQWlCLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFBO1lBQ2hDLENBQUM7aUJBQU0sSUFBSSxLQUFLLENBQUMsTUFBTSxJQUFJLENBQUMsRUFBRSxDQUFDO2dCQUMzQixJQUFJLEdBQUcsSUFBSSxDQUFBO1lBQ2YsQ0FBQztRQUNMLENBQUM7YUFBTSxDQUFDO1lBQ0osSUFBSSxLQUFLLENBQUMsTUFBTSxJQUFJLENBQUM7Z0JBQUUsTUFBTSxJQUFJLG9CQUFvQixDQUFDLGdDQUFnQyxDQUFDLENBQUE7WUFFdkYsSUFBSSxLQUFLLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRSxDQUFDO2dCQUNuQix1QkFBdUI7Z0JBQ3ZCLGlCQUFpQixDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQTtZQUNoQyxDQUFDO2lCQUFNLENBQUM7Z0JBQ0osV0FBVztnQkFDWCxNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxDQUFBO2dCQUMvQixJQUFJLEtBQUssS0FBSyxDQUFDLENBQUMsRUFBRSxDQUFDO29CQUNmLE1BQU0sSUFBSSxvQkFBb0IsQ0FBQyx5QkFBeUIsSUFBSSxFQUFFLENBQUMsQ0FBQTtnQkFDbkUsQ0FBQztnQkFDRCxNQUFNLElBQUksR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUMsRUFBRSxLQUFLLENBQUMsQ0FBQTtnQkFDakMsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxLQUFLLEdBQUcsQ0FBQyxDQUFDLENBQUE7Z0JBRW5DLE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUE7Z0JBQzlCLE1BQU0sUUFBUSxHQUFHO29CQUNiLElBQUksRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDO29CQUNmLE1BQU0sRUFBRSxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQztvQkFDdkIsS0FBSyxFQUFFLEtBQUs7aUJBQ2YsQ0FBQTtnQkFFRCxTQUFTLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsQ0FBQTtZQUN2QyxDQUFDO1FBQ0wsQ0FBQztJQUNMLENBQUM7SUFFRDs7Ozs7Ozs7Ozs7Ozs7OztNQWdCRTtJQUNGLElBQUksWUFBWSxHQUFHLEVBQUUsQ0FBQTtJQUNyQixJQUFJLEtBQUssRUFBRSxNQUFNLElBQUksSUFBSSxLQUFLLEVBQUUsQ0FBQztRQUM3QixJQUFJLElBQUksQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLElBQUksSUFBSSxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO1lBQ2hELGtFQUFrRTtZQUNsRSxZQUFZLElBQUksSUFBSSxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsRUFBRSxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFBO1FBQ3ZELENBQUM7YUFBTSxDQUFDO1lBQ0osSUFBSSxZQUFZLEVBQUUsQ0FBQztnQkFDZixxQ0FBcUM7Z0JBQ3JDLE1BQU0sV0FBVyxDQUFDLFlBQVksQ0FBQyxDQUFBO1lBQ25DLENBQUM7WUFDRCw0QkFBNEI7WUFDNUIsWUFBWSxHQUFHLElBQUksQ0FBQTtRQUN2QixDQUFDO0lBQ0wsQ0FBQztJQUVELGlDQUFpQztJQUNqQyxNQUFNLFdBQVcsQ0FBQyxZQUFZLENBQUMsQ0FBQTtJQUUvQix1Q0FBdUM7SUFDdkMsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO1FBQ1IsTUFBTSxJQUFJLG9CQUFvQixDQUFDLGtCQUFrQixDQUFDLENBQUE7SUFDdEQsQ0FBQztJQUVELE9BQU8sU0FBUyxDQUFBO0FBQ3BCLENBQUM7QUFFRDs7O0dBR0c7QUFDSSxLQUFLLFVBQVUsaUJBQWlCLENBQUMsSUFBWTtJQUNoRCxNQUFNLE1BQU0sR0FBRyxpQkFBUSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQTtJQUNsQyxNQUFNLEtBQUssR0FBRyxrQkFBUSxDQUFDLGVBQWUsQ0FBQyxFQUFFLEtBQUssRUFBRSxNQUFNLEVBQUUsU0FBUyxFQUFFLFFBQVEsRUFBRSxDQUFDLENBQUE7SUFDOUUsT0FBTyxXQUFXLENBQUMsS0FBSyxDQUFDLENBQUE7QUFDN0IsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSSxLQUFLLFVBQVUsYUFBYSxDQUFDLElBQVk7SUFDNUMsTUFBTSxTQUFTLEdBQUcsTUFBTSxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsQ0FBQTtJQUMvQyxJQUFJLFNBQVMsQ0FBQyxJQUFJLEtBQUssV0FBVztRQUM5QixNQUFNLElBQUksb0JBQW9CLENBQUMsZ0JBQWdCLENBQUMsQ0FBQTtJQUNwRCxPQUFPLElBQUkscUJBQVEsQ0FBQyxTQUFTLENBQUMsQ0FBQTtBQUNsQyxDQUFDO0FBRUQ7Ozs7R0FJRztBQUNJLEtBQUssVUFBVSxVQUFVLENBQUMsSUFBWTtJQUN6QyxNQUFNLFNBQVMsR0FBRyxNQUFNLGlCQUFpQixDQUFDLElBQUksQ0FBQyxDQUFBO0lBQy9DLElBQUksU0FBUyxDQUFDLElBQUksS0FBSyxRQUFRO1FBQzNCLE1BQU0sSUFBSSxvQkFBb0IsQ0FBQyxjQUFjLENBQUMsQ0FBQTtJQUNsRCxPQUFPLElBQUksMEJBQWEsQ0FBQyxTQUFTLENBQUMsQ0FBQTtBQUN2QyxDQUFDO0FBRUQsU0FBZ0IsU0FBUyxDQUFDLFlBQXNCO0lBQzVDLE1BQU0sS0FBSyxHQUFHLFlBQVksQ0FBQyxLQUFLLENBQUMsSUFBSSxFQUFFLENBQUE7SUFDdkMsSUFBSSxZQUFZLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxZQUFZLENBQUMsRUFBRSxDQUFDO1FBQzdDLGtCQUFrQjtRQUNsQixPQUFPLElBQUksSUFBSSxDQUFDLEdBQUcsS0FBSyxDQUFDLFNBQVMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLElBQUksS0FBSyxDQUFDLFNBQVMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLElBQUksS0FBSyxDQUFDLFNBQVMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFBO0lBQ2pHLENBQUM7U0FBTSxDQUFDO1FBQ0osc0JBQXNCO1FBQ3RCLE9BQU8sSUFBSSxJQUFJLENBQUMsR0FBRyxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsSUFBSSxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsSUFBSSxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsSUFBSSxLQUFLLENBQUMsU0FBUyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsSUFBSSxLQUFLLENBQUMsU0FBUyxDQUFDLEVBQUUsRUFBRSxFQUFFLENBQUMsSUFBSSxLQUFLLENBQUMsU0FBUyxDQUFDLEVBQUUsRUFBRSxFQUFFLENBQUMsRUFBRSxDQUFDLENBQUE7SUFDakwsQ0FBQztBQUNMLENBQUM7QUFFRCxTQUFnQixZQUFZLENBQUMsSUFBVTtJQUNuQyxPQUFPLEdBQUcsSUFBSSxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQyxDQUFDLEVBQUUsR0FBRyxDQUFDLEdBQUcsSUFBSSxDQUFDLFVBQVUsRUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQyxDQUFDLEVBQUUsR0FBRyxDQUFDLEdBQUcsSUFBSSxDQUFDLFVBQVUsRUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQyxDQUFDLEVBQUUsR0FBRyxDQUFDLEVBQUUsQ0FBQTtBQUMzSixDQUFDO0FBRUQsU0FBZ0IsWUFBWSxDQUFDLElBQVU7SUFDbkMsT0FBTyxHQUFHLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxRQUFRLENBQUMsQ0FBQyxFQUFFLEdBQUcsQ0FBQyxHQUFHLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxRQUFRLENBQUMsQ0FBQyxFQUFFLEdBQUcsQ0FBQyxHQUFHLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxRQUFRLENBQUMsQ0FBQyxFQUFFLEdBQUcsQ0FBQyxFQUFFLENBQUE7QUFDekosQ0FBQztBQUVELFNBQWdCLGdCQUFnQixDQUFDLElBQVU7SUFDdkMsT0FBTyxHQUFHLFlBQVksQ0FBQyxJQUFJLENBQUMsSUFBSSxZQUFZLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQTtBQUN4RCxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGFyc2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvcGFyc2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBZ0JBLG9EQW1JQztBQVNELGtDQUlDO0FBUUQsZ0VBU0M7QUFTRCw4Q0FFQztBQU9ELHNDQUdDO0FBT0QsZ0NBR0M7QUFoTkQsd0RBQStCO0FBQy9CLG1DQUFpQztBQUNqQywyQ0FBdUM7QUFDdkMsNkNBQXNEO0FBRXRELCtFQUErRTtBQUMvRSxNQUFhLG9CQUFxQixTQUFRLEtBQUs7SUFDM0MsSUFBSSxHQUFHLHNCQUFzQixDQUFBO0NBQ2hDO0FBRkQsb0RBRUM7QUFFRDs7Ozs7R0FLRztBQUNJLEtBQUssVUFBVSxvQkFBb0IsQ0FDdEMsS0FBeUI7SUFFekIsTUFBTSxTQUFTLEdBQUcsSUFBSSxxQkFBUyxDQUFDLEVBQUUsQ0FBQyxDQUFBO0lBQ25DLElBQUksSUFBSSxHQUFHLEtBQUssQ0FBQTtJQUVoQixvREFBb0Q7SUFDcEQsTUFBTSxLQUFLLEdBQUcsSUFBSSxLQUFLLEVBQVUsQ0FBQTtJQUVqQyxNQUFNLGlCQUFpQixHQUFHLElBQUksS0FBSyxFQUFVLENBQUE7SUFFN0MsTUFBTSxXQUFXLEdBQUcsS0FBSyxFQUFFLElBQVksRUFBRSxFQUFFO1FBQ3ZDLElBQUksSUFBSSxDQUFDLElBQUksRUFBRSxLQUFLLEVBQUU7WUFBRSxPQUFNO1FBRTlCLElBQUksSUFBSSxFQUFFLENBQUM7WUFDUCxNQUFNLElBQUksb0JBQW9CLENBQzFCLHlDQUF5QyxDQUM1QyxDQUFBO1FBQ0wsQ0FBQztRQUVELElBQUksSUFBSSxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO1lBQzVCLGtCQUFrQjtZQUNsQixNQUFNLElBQUksR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUE7WUFDOUMsS0FBSyxDQUFDLElBQUksQ0FBQyxJ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

package/lib/patterns.d.ts

@@ -0,0 +1,36 @@
+export declare const CONTROL: RegExp;
+export declare const NON_US_ASCII: RegExp;
+export declare const VALUE_CHAR: RegExp;
+export declare const SAFE_CHAR: RegExp;
+export declare const QSAFE_CHAR: RegExp;
+export declare const quotedString: RegExp;
+export declare const value: RegExp;
+export declare const paramtext: RegExp;
+export declare const paramValue: RegExp;
+export declare const vendorId: RegExp;
+export declare const xName: RegExp;
+export declare const ianaToken: RegExp;
+export declare const paramName: RegExp;
+export declare const param: RegExp;
+export declare const name: RegExp;
+export declare const contentline: RegExp;
+export declare const TSAFE_CHAR: RegExp;
+export declare const valueTypeBinary: RegExp;
+export declare const valueTypeBoolean: RegExp;
+export declare const valueTypeDate: RegExp;
+export declare const valueTypeDateTime: RegExp;
+export declare const valueTypeDuration: RegExp;
+export declare const valueTypeFloat: RegExp;
+export declare const valueTypeInteger: RegExp;
+export declare const valueTypePeriod: RegExp;
+export declare const valueTypeText: RegExp;
+export declare const valueTypeTime: RegExp;
+export declare const valueTypeUtcOffset: RegExp;
+/**
+ * Check if a string matches a pattern for the whole string.
+ * @param pattern The RegExp pattern to match against.
+ * @param text The text to check.
+ * @returns Whether or not the string matches.
+ */
+export declare function matchesWholeString(pattern: RegExp, text: string): boolean;
+//# sourceMappingURL=patterns.d.ts.map

package/lib/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../src/patterns.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,QAA8B,CAAA;AAClD,eAAO,MAAM,YAAY,QAAkB,CAAA;AAC3C,eAAO,MAAM,UAAU,QAEtB,CAAA;AACD,eAAO,MAAM,SAAS,QAIrB,CAAA;AACD,eAAO,MAAM,UAAU,QAEtB,CAAA;AACD,eAAO,MAAM,YAAY,QAA+C,CAAA;AACxE,eAAO,MAAM,KAAK,QAA6C,CAAA;AAC/D,eAAO,MAAM,SAAS,QAA4C,CAAA;AAClE,eAAO,MAAM,UAAU,QAEtB,CAAA;AACD,eAAO,MAAM,QAAQ,QAAmB,CAAA;AACxC,eAAO,MAAM,KAAK,QAA0D,CAAA;AAC5E,eAAO,MAAM,SAAS,QAAiB,CAAA;AACvC,eAAO,MAAM,SAAS,QAAoD,CAAA;AAC1E,eAAO,MAAM,KAAK,QAEjB,CAAA;AACD,eAAO,MAAM,IAAI,QAAoD,CAAA;AACrE,eAAO,MAAM,WAAW,QAEvB,CAAA;AAED,eAAO,MAAM,UAAU,QAItB,CAAA;AAGD,eAAO,MAAM,eAAe,QACgC,CAAA;AAC5D,eAAO,MAAM,gBAAgB,QAAiB,CAAA;AAC9C,eAAO,MAAM,aAAa,QAAa,CAAA;AACvC,eAAO,MAAM,iBAAiB,QAAwB,CAAA;AACtD,eAAO,MAAM,iBAAiB,QACqH,CAAA;AACnJ,eAAO,MAAM,cAAc,QAA8B,CAAA;AACzD,eAAO,MAAM,gBAAgB,QAAmB,CAAA;AAChD,eAAO,MAAM,eAAe,QAE3B,CAAA;AACD,eAAO,MAAM,aAAa,QAEzB,CAAA;AACD,eAAO,MAAM,aAAa,QAAe,CAAA;AACzC,eAAO,MAAM,kBAAkB,QAAwB,CAAA;AAEvD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzE"}

package/lib/patterns.js

@@ -0,0 +1,50 @@
+"use strict";
+/* eslint-disable no-control-regex */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.valueTypeUtcOffset = exports.valueTypeTime = exports.valueTypeText = exports.valueTypePeriod = exports.valueTypeInteger = exports.valueTypeFloat = exports.valueTypeDuration = exports.valueTypeDateTime = exports.valueTypeDate = exports.valueTypeBoolean = exports.valueTypeBinary = exports.TSAFE_CHAR = exports.contentline = exports.name = exports.param = exports.paramName = exports.ianaToken = exports.xName = exports.vendorId = exports.paramValue = exports.paramtext = exports.value = exports.quotedString = exports.QSAFE_CHAR = exports.SAFE_CHAR = exports.VALUE_CHAR = exports.NON_US_ASCII = exports.CONTROL = void 0;
+exports.matchesWholeString = matchesWholeString;
+// ABNF patterns from RFC5545
+exports.CONTROL = /[\x00-\x08\x0A-\x1F\x7F]/g;
+exports.NON_US_ASCII = /[^\x00-\x7F]/g;
+exports.VALUE_CHAR = new RegExp(/[\x09\x20\x21-\x7E]/.source + '|' + exports.NON_US_ASCII.source);
+exports.SAFE_CHAR = new RegExp(/[\x09\x20\x21\x23-\x2B\x2D-\x39\x3C-\x7E]/.source +
+    '|' +
+    exports.NON_US_ASCII.source);
+exports.QSAFE_CHAR = new RegExp(/[\x09\x20\x21\x23-\x7E]/.source + '|(' + exports.NON_US_ASCII.source + ')');
+exports.quotedString = new RegExp('"(' + exports.QSAFE_CHAR.source + ')*"');
+exports.value = new RegExp('(' + exports.VALUE_CHAR.source + ')*');
+exports.paramtext = new RegExp('(' + exports.SAFE_CHAR.source + ')*');
+exports.paramValue = new RegExp('(' + exports.paramtext.source + ')|(' + exports.quotedString.source + ')');
+exports.vendorId = /[0-9a-zA-Z]{3}/;
+exports.xName = new RegExp('X-(' + exports.vendorId.source + '-)?[0-9a-zA-Z-]');
+exports.ianaToken = /[0-9a-zA-Z-]/;
+exports.paramName = new RegExp(exports.ianaToken.source + '|' + exports.xName.source);
+exports.param = new RegExp(exports.paramName.source + '=' + exports.paramValue.source + '(,' + exports.paramValue.source + ')*');
+exports.name = new RegExp(exports.ianaToken.source + '|' + exports.xName.source);
+exports.contentline = new RegExp(exports.name.source + '(;' + exports.param.source + ')*:' + exports.xName.source + '\r\n');
+exports.TSAFE_CHAR = new RegExp(/[\x09\x20\x21\x23-\x2B\x2D-\x39\x3C-\x5B\x5D-\x7E]/.source +
+    '|' +
+    exports.NON_US_ASCII.source);
+// Property value type patterns
+exports.valueTypeBinary = /([0-9a-zA-Z+/]{4})*([0-9a-zA-Z]{2}==|[0-9a-zA-Z]{3}=)?/;
+exports.valueTypeBoolean = /(TRUE|FALSE)/;
+exports.valueTypeDate = /[0-9]{8}/;
+exports.valueTypeDateTime = /[0-9]{8}T[0-9]{6}Z?/;
+exports.valueTypeDuration = /(\+?|-)P([0-9]+D(T([0-9]+H([0-9]+M([0-9]+S)?)?|[0-9]+M([0-9]+S)?|[0-9]+S))?|T([0-9]+H([0-9]+M([0-9]+S)?)?|[0-9]+M([0-9]+S)?|[0-9]+S)|[0-9]+W)/;
+exports.valueTypeFloat = /(\+?|-)?[0-9]+(\.[0-9]+)?/;
+exports.valueTypeInteger = /(\+?|-)?[0-9]+/;
+exports.valueTypePeriod = new RegExp(`${exports.valueTypeDateTime.source}/(${exports.valueTypeDateTime}|${exports.valueTypeDuration.source})`);
+exports.valueTypeText = new RegExp('((' + exports.TSAFE_CHAR.source + ')|:|"|\\[\\;,Nn])*');
+exports.valueTypeTime = /[0-9]{6}Z?/;
+exports.valueTypeUtcOffset = /[+-]([0-9]{2}){2,3}/;
+/**
+ * Check if a string matches a pattern for the whole string.
+ * @param pattern The RegExp pattern to match against.
+ * @param text The text to check.
+ * @returns Whether or not the string matches.
+ */
+function matchesWholeString(pattern, text) {
+    const match = text.match(pattern);
+    return match !== null && match[0] === text;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGF0dGVybnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvcGF0dGVybnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLHFDQUFxQzs7O0FBaUVyQyxnREFHQztBQWxFRCw2QkFBNkI7QUFDaEIsUUFBQSxPQUFPLEdBQUcsMkJBQTJCLENBQUE7QUFDckMsUUFBQSxZQUFZLEdBQUcsZUFBZSxDQUFBO0FBQzlCLFFBQUEsVUFBVSxHQUFHLElBQUksTUFBTSxDQUNoQyxxQkFBcUIsQ0FBQyxNQUFNLEdBQUcsR0FBRyxHQUFHLG9CQUFZLENBQUMsTUFBTSxDQUMzRCxDQUFBO0FBQ1ksUUFBQSxTQUFTLEdBQUcsSUFBSSxNQUFNLENBQy9CLDJDQUEyQyxDQUFDLE1BQU07SUFDOUMsR0FBRztJQUNILG9CQUFZLENBQUMsTUFBTSxDQUMxQixDQUFBO0FBQ1ksUUFBQSxVQUFVLEdBQUcsSUFBSSxNQUFNLENBQ2hDLHlCQUF5QixDQUFDLE1BQU0sR0FBRyxJQUFJLEdBQUcsb0JBQVksQ0FBQyxNQUFNLEdBQUcsR0FBRyxDQUN0RSxDQUFBO0FBQ1ksUUFBQSxZQUFZLEdBQUcsSUFBSSxNQUFNLENBQUMsSUFBSSxHQUFHLGtCQUFVLENBQUMsTUFBTSxHQUFHLEtBQUssQ0FBQyxDQUFBO0FBQzNELFFBQUEsS0FBSyxHQUFHLElBQUksTUFBTSxDQUFDLEdBQUcsR0FBRyxrQkFBVSxDQUFDLE1BQU0sR0FBRyxJQUFJLENBQUMsQ0FBQTtBQUNsRCxRQUFBLFNBQVMsR0FBRyxJQUFJLE1BQU0sQ0FBQyxHQUFHLEdBQUcsaUJBQVMsQ0FBQyxNQUFNLEdBQUcsSUFBSSxDQUFDLENBQUE7QUFDckQsUUFBQSxVQUFVLEdBQUcsSUFBSSxNQUFNLENBQ2hDLEdBQUcsR0FBRyxpQkFBUyxDQUFDLE1BQU0sR0FBRyxLQUFLLEdBQUcsb0JBQVksQ0FBQyxNQUFNLEdBQUcsR0FBRyxDQUM3RCxDQUFBO0FBQ1ksUUFBQSxRQUFRLEdBQUcsZ0JBQWdCLENBQUE7QUFDM0IsUUFBQSxLQUFLLEdBQUcsSUFBSSxNQUFNLENBQUMsS0FBSyxHQUFHLGdCQUFRLENBQUMsTUFBTSxHQUFHLGlCQUFpQixDQUFDLENBQUE7QUFDL0QsUUFBQSxTQUFTLEdBQUcsY0FBYyxDQUFBO0FBQzFCLFFBQUEsU0FBUyxHQUFHLElBQUksTUFBTSxDQUFDLGlCQUFTLENBQUMsTUFBTSxHQUFHLEdBQUcsR0FBRyxhQUFLLENBQUMsTUFBTSxDQUFDLENBQUE7QUFDN0QsUUFBQSxLQUFLLEdBQUcsSUFBSSxNQUFNLENBQzNCLGlCQUFTLENBQUMsTUFBTSxHQUFHLEdBQUcsR0FBRyxrQkFBVSxDQUFDLE1BQU0sR0FBRyxJQUFJLEdBQUcsa0JBQVUsQ0FBQyxNQUFNLEdBQUcsSUFBSSxDQUMvRSxDQUFBO0FBQ1ksUUFBQSxJQUFJLEdBQUcsSUFBSSxNQUFNLENBQUMsaUJBQVMsQ0FBQyxNQUFNLEdBQUcsR0FBRyxHQUFHLGFBQUssQ0FBQyxNQUFNLENBQUMsQ0FBQTtBQUN4RCxRQUFBLFdBQVcsR0FBRyxJQUFJLE1BQU0sQ0FDakMsWUFBSSxDQUFDLE1BQU0sR0FBRyxJQUFJLEdBQUcsYUFBSyxDQUFDLE1BQU0sR0FBRyxLQUFLLEdBQUcsYUFBSyxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQ3BFLENBQUE7QUFFWSxRQUFBLFVBQVUsR0FBRyxJQUFJLE1BQU0sQ0FDaEMsb0RBQW9ELENBQUMsTUFBTTtJQUN2RCxHQUFHO0lBQ0gsb0JBQVksQ0FBQyxNQUFNLENBQzFCLENBQUE7QUFFRCwrQkFBK0I7QUFDbEIsUUFBQSxlQUFlLEdBQ3hCLHdEQUF3RCxDQUFBO0FBQy9DLFFBQUEsZ0JBQWdCLEdBQUcsY0FBYyxDQUFBO0FBQ2pDLFFBQUEsYUFBYSxHQUFHLFVBQVUsQ0FBQTtBQUMxQixRQUFBLGlCQUFpQixHQUFHLHFCQUFxQixDQUFBO0FBQ3pDLFFBQUEsaUJBQWlCLEdBQzFCLCtJQUErSSxDQUFBO0FBQ3RJLFFBQUEsY0FBYyxHQUFHLDJCQUEyQixDQUFBO0FBQzVDLFFBQUEsZ0JBQWdCLEdBQUcsZ0JBQWdCLENBQUE7QUFDbkMsUUFBQSxlQUFlLEdBQUcsSUFBSSxNQUFNLENBQ3JDLEdBQUcseUJBQWlCLENBQUMsTUFBTSxLQUFLLHlCQUFpQixJQUFJLHlCQUFpQixDQUFDLE1BQU0sR0FBRyxDQUNuRixDQUFBO0FBQ1ksUUFBQSxhQUFhLEdBQUcsSUFBSSxNQUFNLENBQ25DLElBQUksR0FBRyxrQkFBVSxDQUFDLE1BQU0sR0FBRyxvQkFBb0IsQ0FDbEQsQ0FBQTtBQUNZLFFBQUEsYUFBYSxHQUFHLFlBQVksQ0FBQTtBQUM1QixRQUFBLGtCQUFrQixHQUFHLHFCQUFxQixDQUFBO0FBRXZEOzs7OztHQUtHO0FBQ0gsU0FBZ0Isa0JBQWtCLENBQUMsT0FBZSxFQUFFLElBQVk7SUFDNUQsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQTtJQUNqQyxPQUFPLEtBQUssS0FBSyxJQUFJLElBQUksS0FBSyxDQUFDLENBQUMsQ0FBQyxLQUFLLElBQUksQ0FBQTtBQUM5QyxDQUFDIn0=

package/lib/property.d.ts

@@ -0,0 +1,149 @@
+export interface Property {
+    name: string;
+    params: string[];
+    value: string;
+}
+export declare const knownPropertyNames: readonly ["CALSCALE", "METHOD", "PRODID", "VERSION", "ATTACH", "CATEGORIES", "CLASS", "COMMENT", "DESCRIPTION", "GEO", "LOCATION", "PERCENT-COMPLETE", "PRIORITY", "RESOURCES", "STATUS", "SUMMARY", "COMPLETED", "DTEND", "DUE", "DTSTART", "DURATION", "FREEBUSY", "TRANSP", "TZID", "TZNAME", "TZOFFSETFROM", "TZOFFSETTO", "TZURL", "ATTENDEE", "CONTACT", "ORGANIZER", "RECURRENCE-ID", "RELATED-TO", "URL", "UID", "EXDATE", "RDATE", "RRULE", "ACTION", "REPEAT", "TRIGGER", "CREATED", "DTSTAMP", "LAST-MODIFIED", "SEQUENCE", "REQUEST-STATUS"];
+export type KnownPropertyName = (typeof knownPropertyNames)[number];
+export type AllowedPropertyName = KnownPropertyName | (`X-${string}` & {}) | (string & {});
+export declare const knownValueTypes: readonly ["BINARY", "BOOLEAN", "CAL-ADDRESS", "DATE", "DATE-TIME", "DURATION", "FLOAT", "INTEGER", "PERIOD", "RECUR", "TEXT", "TIME", "URI", "UTC-OFFSET"];
+export type KnownValueType = (typeof knownValueTypes)[number];
+export type AllowedValueType = KnownValueType | (string & {});
+/**
+ * The value types that each property supports as defined by the iCalendar
+ * specification. The first in the list is the default type.
+ */
+export declare const supportedValueTypes: {
+    [name in KnownPropertyName]: KnownValueType[];
+};
+/**
+ * Get the value type of a property, as defined by the VALUE parameter.
+ * @param property The property to get the value type of.
+ * @returns The value type if present, else `undefined`.
+ * @throws If the parameter value is misformed.
+ */
+export declare function getPropertyValueType(property: Property): AllowedValueType | undefined;
+/**
+ * Get the value type of a property, as defined by the VALUE parameter.
+ * @param property The property to get the value type of.
+ * @param defaultValue The default value to return if the property VALUE parameter is not present.
+ * @returns The value type if present, else `defaultValue` or `undefined`.
+ * @throws If the parameter value is misformed.
+ */
+export declare function getPropertyValueType(property: Property, defaultValue: AllowedValueType): AllowedValueType;
+export declare function getPropertyValueType(property: Property, defaultValue: AllowedValueType | undefined): AllowedValueType | undefined;
+/** Represents an error which occurs while validating a calendar property. */
+export declare class PropertyValidationError extends Error {
+    constructor(message: string);
+}
+/** Represents an error which occurs if a required property is missing. */
+export declare class MissingPropertyError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validate if a property value is a valid binary string.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateBinary(value: string): void;
+/**
+ * Validate if a property value is a valid boolean.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateBoolean(value: string): void;
+/**
+ * Validate if a property value is a valid calendar user address.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateCalendarUserAddress(value: string): void;
+/**
+ * Validate if a property value is a valid date.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateDate(value: string): void;
+/**
+ * Validate if a property value is a valid date-time.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateDateTime(value: string): void;
+/**
+ * Validate if a property value is a valid duration.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateDuration(value: string): void;
+/**
+ * Validate if a property value is a valid float.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateFloat(value: string): void;
+/**
+ * Validate if a property value is a valid integer.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateInteger(value: string): void;
+/**
+ * Validate if a property value is a valid period.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validatePeriod(value: string): void;
+/**
+ * Validate if a property value is a valid recurrence rule.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateRecurrenceRule(value: string): void;
+/**
+ * Validate if a property value is valid text.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateText(value: string): void;
+/**
+ * Validate if a property value is a valid time.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateTime(value: string): void;
+/**
+ * Validate if a property value is a valid URI.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateUri(value: string): void;
+/**
+ * Validate if a property value is a valid UTC offset.
+ * @param value The property value to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateUtcOffset(value: string): void;
+/**
+ * Validate a property value for a set value type.
+ * @param value The property value to validate.
+ * @param type The property value type which `value` will be validated against.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateValue(value: string, type: AllowedValueType): void;
+/**
+ * Validate the value of a property based on it's value type.
+ *
+ * The validation will fail if the property:
+ *
+ * - has a value which is not valid for its value type.
+ * - has a value type which is not valid for that property.
+ * - has no known value type and is invalid TEXT. (see below)
+ *
+ * Unknown properties are validated as TEXT by if no value type is set, as
+ * defined by {@link https://datatracker.ietf.org/doc/html/rfc5545#section-3.8.8|RFC5545#3.8.8.}
+ * @param property The property to validate.
+ * @throws {PropertyValidationError} If the validation fails.
+ */
+export declare function validateProperty(property: Property): void;
+//# sourceMappingURL=property.d.ts.map

package/lib/property.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property.d.ts","sourceRoot":"","sources":["../src/property.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,eAAO,MAAM,kBAAkB,0hBA+CrB,CAAA;AACV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AACnE,MAAM,MAAM,mBAAmB,GACzB,iBAAiB,GACjB,CAAC,KAAK,MAAM,EAAE,GAAG,EAAE,CAAC,GACpB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEnB,eAAO,MAAM,eAAe,4JAelB,CAAA;AACV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAC7D,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE7D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE;KAC7B,IAAI,IAAI,iBAAiB,GAAG,cAAc,EAAE;CAgDhD,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,QAAQ,GACnB,gBAAgB,GAAG,SAAS,CAAA;AAE/B;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,gBAAgB,GAC/B,gBAAgB,CAAA;AACnB,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,gBAAgB,GAAG,SAAS,GAC3C,gBAAgB,GAAG,SAAS,CAAA;AAqB/B,6EAA6E;AAC7E,qBAAa,uBAAwB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI9B;AAED,0EAA0E;AAC1E,qBAAa,oBAAqB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI9B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,QAK3C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,QAK5C;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,QAQxD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,QAQzC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,QAQ7C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,QAK7C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,QAK1C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,QAK5C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,QAK3C;AAED;;;;GAIG;AAEH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,QAEnD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,QAKzC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,QAKzC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,QAQxC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,QAK9C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,QAgDlE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,QAuClD"}