@pipobscure/vcard 0.0.1

package/dist/escape.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Text escaping and unescaping for vCard v4 (RFC 6350 section 3.4)
+ *
+ * In TEXT value types:
+ *   \\ → \
+ *   \n or \N → newline (U+000A)
+ *   \, → ,
+ *   \; → ;
+ *
+ * On output, these characters must be escaped:
+ *   \ → \\
+ *   newline → \n
+ *   , → \,  (only in compound/list fields)
+ *   ; → \;  (always in structured fields)
+ */
+/** Unescape a single text component (after splitting on `;` or `,`) */
+export declare function unescapeText(s: string): string;
+/** Escape a text value for use as a TEXT property value (no structural chars) */
+export declare function escapeText(s: string): string;
+/**
+ * Escape a text value that is a component of a structured/list property.
+ * The caller is responsible for joining components with `;` or `,`.
+ * Only escapes `\`, `\n`, and `;` — the `,` within a component (for list-within-struct).
+ */
+export declare function escapeStructuredComponent(s: string): string;
+/**
+ * Split a structured value on `;`, respecting backslash escapes.
+ * Returns raw (still-escaped) components.
+ */
+export declare function splitStructured(value: string): string[];
+/**
+ * Split a compound value on `,`, respecting backslash escapes.
+ * Returns raw (still-escaped) items.
+ */
+export declare function splitList(value: string): string[];
+/** Unescape and split a structured value into its components */
+export declare function parseStructured(value: string): string[];
+/** Unescape and split a list value into its items */
+export declare function parseList(value: string): string[];
+/** Unescape and split a structured-with-lists value.
+ *  Each `;`-separated component may itself be a `,`-separated list.
+ */
+export declare function parseStructuredList(value: string): string[][];
+/**
+ * Check whether a parameter value needs quoting (RFC 6350 section 5.1).
+ * Param values containing `:`, `;`, or `,` must be quoted.
+ */
+export declare function needsParamQuoting(value: string): boolean;
+/**
+ * Quote a parameter value if necessary.
+ * Existing double-quotes within the value are escaped as \".
+ */
+export declare function quoteParamValue(value: string): string;
+/**
+ * Unquote a parameter value (remove surrounding quotes if present,
+ * unescape internal \" sequences).
+ */
+export declare function unquoteParamValue(value: string): string;
+//# sourceMappingURL=escape.d.ts.map

package/dist/escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../src/escape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBvD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBjD;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAE7D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKvD"}

package/dist/escape.js

@@ -0,0 +1,136 @@
+/**
+ * Text escaping and unescaping for vCard v4 (RFC 6350 section 3.4)
+ *
+ * In TEXT value types:
+ *   \\ → \
+ *   \n or \N → newline (U+000A)
+ *   \, → ,
+ *   \; → ;
+ *
+ * On output, these characters must be escaped:
+ *   \ → \\
+ *   newline → \n
+ *   , → \,  (only in compound/list fields)
+ *   ; → \;  (always in structured fields)
+ */
+/** Unescape a single text component (after splitting on `;` or `,`) */
+export function unescapeText(s) {
+    return s.replace(/\\(\\|n|N|,|;)/g, (_, c) => {
+        if (c === 'n' || c === 'N')
+            return '\n';
+        if (c === '\\')
+            return '\\';
+        if (c === ',')
+            return ',';
+        if (c === ';')
+            return ';';
+        return c;
+    });
+}
+/** Escape a text value for use as a TEXT property value (no structural chars) */
+export function escapeText(s) {
+    return s
+        .replace(/\\/g, '\\\\')
+        .replace(/\n/g, '\\n')
+        .replace(/,/g, '\\,')
+        .replace(/;/g, '\\;');
+}
+/**
+ * Escape a text value that is a component of a structured/list property.
+ * The caller is responsible for joining components with `;` or `,`.
+ * Only escapes `\`, `\n`, and `;` — the `,` within a component (for list-within-struct).
+ */
+export function escapeStructuredComponent(s) {
+    return s
+        .replace(/\\/g, '\\\\')
+        .replace(/\n/g, '\\n')
+        .replace(/;/g, '\\;')
+        .replace(/,/g, '\\,');
+}
+/**
+ * Split a structured value on `;`, respecting backslash escapes.
+ * Returns raw (still-escaped) components.
+ */
+export function splitStructured(value) {
+    const parts = [];
+    let current = '';
+    for (let i = 0; i < value.length; i++) {
+        const ch = value[i];
+        if (ch === '\\' && i + 1 < value.length) {
+            current += ch + value[++i];
+        }
+        else if (ch === ';') {
+            parts.push(current);
+            current = '';
+        }
+        else {
+            current += ch;
+        }
+    }
+    parts.push(current);
+    return parts;
+}
+/**
+ * Split a compound value on `,`, respecting backslash escapes.
+ * Returns raw (still-escaped) items.
+ */
+export function splitList(value) {
+    const parts = [];
+    let current = '';
+    for (let i = 0; i < value.length; i++) {
+        const ch = value[i];
+        if (ch === '\\' && i + 1 < value.length) {
+            current += ch + value[++i];
+        }
+        else if (ch === ',') {
+            parts.push(current);
+            current = '';
+        }
+        else {
+            current += ch;
+        }
+    }
+    parts.push(current);
+    return parts;
+}
+/** Unescape and split a structured value into its components */
+export function parseStructured(value) {
+    return splitStructured(value).map(unescapeText);
+}
+/** Unescape and split a list value into its items */
+export function parseList(value) {
+    return splitList(value).map(unescapeText);
+}
+/** Unescape and split a structured-with-lists value.
+ *  Each `;`-separated component may itself be a `,`-separated list.
+ */
+export function parseStructuredList(value) {
+    return splitStructured(value).map(component => parseList(component));
+}
+/**
+ * Check whether a parameter value needs quoting (RFC 6350 section 5.1).
+ * Param values containing `:`, `;`, or `,` must be quoted.
+ */
+export function needsParamQuoting(value) {
+    return /[;:,"]/.test(value);
+}
+/**
+ * Quote a parameter value if necessary.
+ * Existing double-quotes within the value are escaped as \".
+ */
+export function quoteParamValue(value) {
+    if (!needsParamQuoting(value))
+        return value;
+    return '"' + value.replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+}
+/**
+ * Unquote a parameter value (remove surrounding quotes if present,
+ * unescape internal \" sequences).
+ */
+export function unquoteParamValue(value) {
+    if (value.startsWith('"') && value.endsWith('"') && value.length >= 2) {
+        return value.slice(1, -1).replace(/\\"/g, '"').replace(/\\\\/g, '\\');
+    }
+    return value;
+}
+//# sourceMappingURL=escape.js.map

package/dist/escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../src/escape.ts"],"names":[],"mappings":"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"}

package/dist/generator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * vCard v4 generator — RFC 6350
+ *
+ * Strict output:
+ *   - CRLF line endings (§3.2)
+ *   - Line folding at 75 octets (§3.2)
+ *   - VERSION:4.0 first property after BEGIN:VCARD
+ *   - Proper text escaping
+ *   - Parameter values quoted when necessary
+ */
+import type { ParameterMap } from './types.js';
+import { Property } from './property.js';
+/**
+ * Fold a content line to at most 75 octets per line (RFC 6350 §3.2).
+ * Continuation lines begin with a single space.
+ * Counts UTF-8 bytes, not characters.
+ */
+export declare function foldLine(line: string): string;
+/**
+ * Serialize a ParameterMap to string (without leading semicolon).
+ * Multiple values for the same parameter are joined with commas.
+ * Values containing special characters are quoted.
+ */
+export declare function serializeParameters(params: ParameterMap): string;
+/**
+ * Serialize a single Property to a folded content line string (with CRLF).
+ */
+export declare function serializeProperty(prop: Property): string;
+export interface GenerateOptions {
+    /**
+     * Whether to validate the vCard before generating.
+     * Default: true
+     */
+    validate?: boolean;
+    /**
+     * Whether to include a PRODID property.
+     * If a string is provided, it is used as the PRODID value.
+     * Default: false
+     */
+    prodid?: boolean | string;
+}
+/**
+ * Serialize a list of properties to a vCard string.
+ * Handles VERSION insertion and ordering.
+ *
+ * @throws VCardError if validation is enabled and the vCard is invalid
+ */
+export declare function serializeVCard(properties: Property[], options?: GenerateOptions): string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAc,MAAM,eAAe,CAAC;AAMrD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmC7C;AAID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAgBhE;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAQxD;AAID,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC3B;AAID;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,QAAQ,EAAE,EACtB,OAAO,GAAE,eAAoB,GAC5B,MAAM,CAoBR"}

package/dist/generator.js

@@ -0,0 +1,194 @@
+/**
+ * vCard v4 generator — RFC 6350
+ *
+ * Strict output:
+ *   - CRLF line endings (§3.2)
+ *   - Line folding at 75 octets (§3.2)
+ *   - VERSION:4.0 first property after BEGIN:VCARD
+ *   - Proper text escaping
+ *   - Parameter values quoted when necessary
+ */
+import { quoteParamValue } from './escape.js';
+import { VCardError } from './property.js';
+// ── Line folding ──────────────────────────────────────────────────────────
+const MAX_LINE_OCTETS = 75;
+/**
+ * Fold a content line to at most 75 octets per line (RFC 6350 §3.2).
+ * Continuation lines begin with a single space.
+ * Counts UTF-8 bytes, not characters.
+ */
+export function foldLine(line) {
+    if (Buffer.byteLength(line, 'utf8') <= MAX_LINE_OCTETS) {
+        return line + '\r\n';
+    }
+    const parts = [];
+    let start = 0;
+    // First segment: 75 octets max.
+    // Continuation segments: 74 octets of content + 1-byte leading space = 75.
+    let maxBytes = MAX_LINE_OCTETS;
+    while (start < line.length) {
+        let end = start;
+        let octetCount = 0;
+        // Advance character by character, counting UTF-8 bytes
+        while (end < line.length) {
+            const cp = line.codePointAt(end);
+            const charBytes = cp > 0xffff ? 4 : cp > 0x7ff ? 3 : cp > 0x7f ? 2 : 1;
+            if (octetCount + charBytes > maxBytes)
+                break;
+            octetCount += charBytes;
+            end += cp > 0xffff ? 2 : 1; // surrogate pair awareness
+        }
+        if (end === start) {
+            // Force-include at least one character to avoid infinite loop
+            end = start + 1;
+        }
+        parts.push(line.slice(start, end));
+        start = end;
+        maxBytes = MAX_LINE_OCTETS - 1; // subsequent lines lose 1 byte to leading space
+    }
+    return parts.join('\r\n ') + '\r\n';
+}
+// ── Parameter serialization ───────────────────────────────────────────────
+/**
+ * Serialize a ParameterMap to string (without leading semicolon).
+ * Multiple values for the same parameter are joined with commas.
+ * Values containing special characters are quoted.
+ */
+export function serializeParameters(params) {
+    const parts = [];
+    for (const [name, value] of params) {
+        if (Array.isArray(value)) {
+            if (value.length === 0)
+                continue;
+            // Multiple values: emit as single NAME=val1,val2 or individual NAME=val for each
+            // RFC 6350 §5.1 allows multi-value params
+            const joined = value.map(quoteParamValue).join(',');
+            parts.push(`${name}=${joined}`);
+        }
+        else {
+            parts.push(`${name}=${quoteParamValue(value)}`);
+        }
+    }
+    return parts.join(';');
+}
+// ── Content line serialization ────────────────────────────────────────────
+/**
+ * Serialize a single Property to a folded content line string (with CRLF).
+ */
+export function serializeProperty(prop) {
+    const namePart = prop.group ? `${prop.group}.${prop.name}` : prop.name;
+    const paramStr = serializeParameters(prop.params);
+    const separator = paramStr ? `;${paramStr}` : '';
+    const value = prop.toContentLine();
+    const line = `${namePart}${separator}:${value}`;
+    return foldLine(line);
+}
+// ── VCard serialization ───────────────────────────────────────────────────
+/**
+ * Serialize a list of properties to a vCard string.
+ * Handles VERSION insertion and ordering.
+ *
+ * @throws VCardError if validation is enabled and the vCard is invalid
+ */
+export function serializeVCard(properties, options = {}) {
+    const validate = options.validate !== false;
+    if (validate) {
+        validateForGeneration(properties);
+    }
+    let output = 'BEGIN:VCARD\r\n';
+    output += 'VERSION:4.0\r\n';
+    // Properties to emit (skip VERSION — already emitted above)
+    // Order: structural first (FN, N), then everything else
+    const ordered = orderProperties(properties.filter(p => p.name !== 'VERSION'));
+    for (const prop of ordered) {
+        output += serializeProperty(prop);
+    }
+    output += 'END:VCARD\r\n';
+    return output;
+}
+// ── Property ordering ─────────────────────────────────────────────────────
+/** Preferred property output order (for readability) */
+const PROPERTY_ORDER = {
+    FN: 1,
+    N: 2,
+    NICKNAME: 3,
+    GENDER: 4,
+    BDAY: 5,
+    ANNIVERSARY: 6,
+    ORG: 7,
+    TITLE: 8,
+    ROLE: 9,
+    EMAIL: 10,
+    TEL: 11,
+    ADR: 12,
+    URL: 13,
+    IMPP: 14,
+    LANG: 15,
+    TZ: 16,
+    GEO: 17,
+    PHOTO: 18,
+    LOGO: 19,
+    SOUND: 20,
+    NOTE: 21,
+    CATEGORIES: 22,
+    SOURCE: 23,
+    XML: 24,
+    KEY: 25,
+    FBURL: 26,
+    CALADRURI: 27,
+    CALURI: 28,
+    MEMBER: 29,
+    RELATED: 30,
+    UID: 31,
+    REV: 32,
+    PRODID: 33,
+    KIND: 34,
+    CLIENTPIDMAP: 35,
+};
+function orderProperties(properties) {
+    return [...properties].sort((a, b) => {
+        const oa = PROPERTY_ORDER[a.name] ?? 100;
+        const ob = PROPERTY_ORDER[b.name] ?? 100;
+        return oa - ob;
+    });
+}
+// ── Validation ─────────────────────────────────────────────────────────────
+/**
+ * Validate a property list for strict vCard v4 generation.
+ * @throws VCardError on first validation failure
+ */
+function validateForGeneration(properties) {
+    // FN is required (cardinality 1*)
+    const fnProps = properties.filter(p => p.name === 'FN');
+    if (fnProps.length === 0) {
+        throw new VCardError('Missing required property: FN', 'FN');
+    }
+    // PREF values must be 1–100
+    for (const prop of properties) {
+        const pref = prop.pref;
+        if (pref !== undefined && (pref < 1 || pref > 100 || !Number.isInteger(pref))) {
+            throw new VCardError(`PREF parameter on ${prop.name} must be an integer between 1 and 100, got: ${pref}`, prop.name);
+        }
+    }
+    // GENDER sex must be one of M, F, O, N, U, or empty
+    for (const prop of properties) {
+        if (prop.name === 'GENDER') {
+            // GenderProperty has a value field
+            const gp = prop;
+            const validSex = ['M', 'F', 'O', 'N', 'U', ''];
+            if (!validSex.includes(gp.value.sex)) {
+                throw new VCardError(`Invalid GENDER sex value: ${gp.value.sex}. Must be one of M, F, O, N, U`, 'GENDER');
+            }
+        }
+    }
+    // REV must be a valid timestamp
+    for (const prop of properties) {
+        if (prop.name === 'REV') {
+            const rp = prop;
+            if (rp.value instanceof Date && isNaN(rp.value.getTime())) {
+                throw new VCardError('REV property contains invalid date', 'REV');
+            }
+        }
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAY,UAAU,EAAE,MAAM,eAAe,CAAC;AAErD,6EAA6E;AAE7E,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QACvD,OAAO,IAAI,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,gCAAgC;IAChC,2EAA2E;IAC3E,IAAI,QAAQ,GAAG,eAAe,CAAC;IAE/B,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,uDAAuD;QACvD,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAE,CAAC;YAClC,MAAM,SAAS,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvE,IAAI,UAAU,GAAG,SAAS,GAAG,QAAQ;gBAAE,MAAM;YAC7C,UAAU,IAAI,SAAS,CAAC;YACxB,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,2BAA2B;QACzD,CAAC;QAED,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YAClB,8DAA8D;YAC9D,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC;QAClB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QACnC,KAAK,GAAG,GAAG,CAAC;QACZ,QAAQ,GAAG,eAAe,GAAG,CAAC,CAAC,CAAC,gDAAgD;IAClF,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC;AACtC,CAAC;AAED,6EAA6E;AAE7E;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACjC,iFAAiF;YACjF,0CAA0C;YAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,6EAA6E;AAE7E;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IACvE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IAEnC,MAAM,IAAI,GAAG,GAAG,QAAQ,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC;IAChD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAmBD,6EAA6E;AAE7E;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAsB,EACtB,UAA2B,EAAE;IAE7B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC;IAE5C,IAAI,QAAQ,EAAE,CAAC;QACb,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,MAAM,GAAG,iBAAiB,CAAC;IAC/B,MAAM,IAAI,iBAAiB,CAAC;IAE5B,4DAA4D;IAC5D,wDAAwD;IACxD,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC;IAE9E,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,IAAI,eAAe,CAAC;IAC1B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6EAA6E;AAE7E,wDAAwD;AACxD,MAAM,cAAc,GAA2B;IAC7C,EAAE,EAAE,CAAC;IACL,CAAC,EAAE,CAAC;IACJ,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,WAAW,EAAE,CAAC;IACd,GAAG,EAAE,CAAC;IACN,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,EAAE;IACT,GAAG,EAAE,EAAE;IACP,GAAG,EAAE,EAAE;IACP,GAAG,EAAE,EAAE;IACP,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,EAAE,EAAE,EAAE;IACN,GAAG,EAAE,EAAE;IACP,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,EAAE;IACV,GAAG,EAAE,EAAE;IACP,GAAG,EAAE,EAAE;IACP,KAAK,EAAE,EAAE;IACT,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,GAAG,EAAE,EAAE;IACP,GAAG,EAAE,EAAE;IACP,MAAM,EAAE,EAAE;IACV,IAAI,EAAE,EAAE;IACR,YAAY,EAAE,EAAE;CACjB,CAAC;AAEF,SAAS,eAAe,CAAC,UAAsB;IAC7C,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACnC,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;QACzC,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;QACzC,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,qBAAqB,CAAC,UAAsB;IACnD,kCAAkC;IAClC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACxD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,UAAU,CAAC,+BAA+B,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,4BAA4B;IAC5B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,UAAU,CAClB,qBAAqB,IAAI,CAAC,IAAI,+CAA+C,IAAI,EAAE,EACnF,IAAI,CAAC,IAAI,CACV,CAAC;QACJ,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,mCAAmC;YACnC,MAAM,EAAE,GAAG,IAA8C,CAAC;YAC1D,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,UAAU,CAClB,6BAA6B,EAAE,CAAC,KAAK,CAAC,GAAG,gCAAgC,EACzE,QAAQ,CACT,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACxB,MAAM,EAAE,GAAG,IAA2C,CAAC;YACvD,IAAI,EAAE,CAAC,KAAK,YAAY,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;gBAC1D,MAAM,IAAI,UAAU,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @pipobscure/vcard — A fully featured vCard v4 (RFC 6350) library
+ *
+ * Provides tolerant parsing and strict generation of vCard data,
+ * designed for use with CardDAV.
+ *
+ * @example
+ * ```ts
+ * import { VCard, FNProperty, EmailProperty } from '@pipobscure/vcard';
+ *
+ * // Parse
+ * const [contact] = VCard.parse(vcardText);
+ * console.log(contact.displayName);    // 'Alice Example'
+ * console.log(contact.primaryEmail);   // 'alice@example.com'
+ *
+ * // Build
+ * const vc = new VCard();
+ * vc.fn.push(new FNProperty('Bob Builder'));
+ * vc.email.push(new EmailProperty('bob@example.com'));
+ * const text = vc.toString();          // strict RFC 6350 output
+ * ```
+ */
+export { VCard, VCardError } from './vcard.js';
+export { Property, TextProperty, TextListProperty, UriProperty, FNProperty, NProperty, NicknameProperty, PhotoProperty, BDayProperty, AnniversaryProperty, GenderProperty, AdrProperty, TelProperty, EmailProperty, IMPPProperty, LangProperty, TZProperty, GeoProperty, TitleProperty, RoleProperty, LogoProperty, OrgProperty, MemberProperty, RelatedProperty, CategoriesProperty, NoteProperty, ProdIDProperty, RevProperty, SoundProperty, UIDProperty, ClientPidMapProperty, URLProperty, KeyProperty, FBURLProperty, CALADRURIProperty, CALURIProperty, KindProperty, XMLProperty, SourceProperty, UnknownProperty, parseDateAndOrTime, formatDateAndOrTime, } from './property.js';
+export type { ValueType, TypeValue, KindValue, GenderSex, PartialDate, TimeValue, DateAndOrTime, StructuredName, Address, Organization, Gender, ClientPidMap, GeoCoordinates, ParameterMap, RawProperty, ValidationResult, ValidationError, } from './types.js';
+export { escapeText, escapeStructuredComponent, unescapeText, parseStructured, parseList, parseStructuredList, needsParamQuoting, quoteParamValue, unquoteParamValue, splitStructured, splitList, } from './escape.js';
+export { unfoldLines, parseContentLine, instantiateProperty, parseVCardText, } from './parser.js';
+export type { ParseWarning, ParseResult, RawVCard } from './parser.js';
+export { foldLine, serializeParameters, serializeProperty, serializeVCard } from './generator.js';
+export type { GenerateOptions } from './generator.js';
+import { VCard } from './vcard.js';
+/**
+ * Parse vCard text and return all vCards found.
+ * Tolerant: never throws, silently accepts malformed input.
+ */
+export declare function parse(text: string): VCard[];
+/**
+ * Parse vCard text and return the first vCard.
+ * @throws Error if no vCard is found
+ */
+export declare function parseOne(text: string): VCard;
+/**
+ * Serialize a VCard (or array of VCards) to RFC 6350 text.
+ * @throws VCardError if the vCard is invalid
+ */
+export declare function stringify(vcard: VCard | VCard[]): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAEL,QAAQ,EAGR,YAAY,EACZ,gBAAgB,EAChB,WAAW,EAGX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,cAAc,EAGd,WAAW,EAGX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EAGZ,UAAU,EACV,WAAW,EAGX,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EAGf,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,WAAW,EAGX,WAAW,EAGX,aAAa,EACb,iBAAiB,EACjB,cAAc,EAGd,YAAY,EACZ,WAAW,EACX,cAAc,EAGd,eAAe,EAGf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,cAAc,EACd,OAAO,EACP,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,UAAU,EACV,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,SAAS,GACV,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvE,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAClG,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,CAE3C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAE5C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,MAAM,CAKxD"}

package/dist/index.js

@@ -0,0 +1,85 @@
+/**
+ * @pipobscure/vcard — A fully featured vCard v4 (RFC 6350) library
+ *
+ * Provides tolerant parsing and strict generation of vCard data,
+ * designed for use with CardDAV.
+ *
+ * @example
+ * ```ts
+ * import { VCard, FNProperty, EmailProperty } from '@pipobscure/vcard';
+ *
+ * // Parse
+ * const [contact] = VCard.parse(vcardText);
+ * console.log(contact.displayName);    // 'Alice Example'
+ * console.log(contact.primaryEmail);   // 'alice@example.com'
+ *
+ * // Build
+ * const vc = new VCard();
+ * vc.fn.push(new FNProperty('Bob Builder'));
+ * vc.email.push(new EmailProperty('bob@example.com'));
+ * const text = vc.toString();          // strict RFC 6350 output
+ * ```
+ */
+// ── Main class ─────────────────────────────────────────────────────────────
+export { VCard, VCardError } from './vcard.js';
+// ── All property classes ───────────────────────────────────────────────────
+export { 
+// Base
+Property, 
+// Text properties
+TextProperty, TextListProperty, UriProperty, 
+// Identification (RFC 6350 §6.2)
+FNProperty, NProperty, NicknameProperty, PhotoProperty, BDayProperty, AnniversaryProperty, GenderProperty, 
+// Delivery addressing (RFC 6350 §6.3)
+AdrProperty, 
+// Communications (RFC 6350 §6.4)
+TelProperty, EmailProperty, IMPPProperty, LangProperty, 
+// Geographic (RFC 6350 §6.5)
+TZProperty, GeoProperty, 
+// Organizational (RFC 6350 §6.6)
+TitleProperty, RoleProperty, LogoProperty, OrgProperty, MemberProperty, RelatedProperty, 
+// Explanatory (RFC 6350 §6.7)
+CategoriesProperty, NoteProperty, ProdIDProperty, RevProperty, SoundProperty, UIDProperty, ClientPidMapProperty, URLProperty, 
+// Security (RFC 6350 §6.8)
+KeyProperty, 
+// Calendar (RFC 6350 §6.9)
+FBURLProperty, CALADRURIProperty, CALURIProperty, 
+// General (RFC 6350 §6.1)
+KindProperty, XMLProperty, SourceProperty, 
+// Unknown / extended
+UnknownProperty, 
+// Date helpers
+parseDateAndOrTime, formatDateAndOrTime, } from './property.js';
+// ── Escape utilities (for advanced usage) ──────────────────────────────────
+export { escapeText, escapeStructuredComponent, unescapeText, parseStructured, parseList, parseStructuredList, needsParamQuoting, quoteParamValue, unquoteParamValue, splitStructured, splitList, } from './escape.js';
+// ── Parser ─────────────────────────────────────────────────────────────────
+export { unfoldLines, parseContentLine, instantiateProperty, parseVCardText, } from './parser.js';
+// ── Generator ──────────────────────────────────────────────────────────────
+export { foldLine, serializeParameters, serializeProperty, serializeVCard } from './generator.js';
+// ── Convenience functions ──────────────────────────────────────────────────
+import { VCard } from './vcard.js';
+/**
+ * Parse vCard text and return all vCards found.
+ * Tolerant: never throws, silently accepts malformed input.
+ */
+export function parse(text) {
+    return VCard.parse(text);
+}
+/**
+ * Parse vCard text and return the first vCard.
+ * @throws Error if no vCard is found
+ */
+export function parseOne(text) {
+    return VCard.parseOne(text);
+}
+/**
+ * Serialize a VCard (or array of VCards) to RFC 6350 text.
+ * @throws VCardError if the vCard is invalid
+ */
+export function stringify(vcard) {
+    if (Array.isArray(vcard)) {
+        return vcard.map(vc => vc.toString()).join('');
+    }
+    return vcard.toString();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,8EAA8E;AAC9E,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/C,8EAA8E;AAC9E,OAAO;AACL,OAAO;AACP,QAAQ;AAER,kBAAkB;AAClB,YAAY,EACZ,gBAAgB,EAChB,WAAW;AAEX,iCAAiC;AACjC,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,cAAc;AAEd,sCAAsC;AACtC,WAAW;AAEX,iCAAiC;AACjC,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY;AAEZ,6BAA6B;AAC7B,UAAU,EACV,WAAW;AAEX,iCAAiC;AACjC,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe;AAEf,8BAA8B;AAC9B,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,WAAW;AAEX,2BAA2B;AAC3B,WAAW;AAEX,2BAA2B;AAC3B,aAAa,EACb,iBAAiB,EACjB,cAAc;AAEd,0BAA0B;AAC1B,YAAY,EACZ,WAAW,EACX,cAAc;AAEd,qBAAqB;AACrB,eAAe;AAEf,eAAe;AACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAuBvB,8EAA8E;AAC9E,OAAO,EACL,UAAU,EACV,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,8EAA8E;AAC9E,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGlG,8EAA8E;AAE9E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAsB;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,54 @@
+/**
+ * vCard v4 parser — RFC 6350
+ *
+ * Design goals:
+ *   - Tolerant: accept malformed input, mixed line endings, v3 quirks
+ *   - Non-throwing: collect parse warnings, never discard data
+ *   - Preserve unknown properties verbatim for round-tripping
+ */
+import type { RawProperty } from './types.js';
+import { Property } from './property.js';
+export interface ParseWarning {
+    line?: number;
+    message: string;
+}
+/**
+ * Unfold content lines per RFC 6350 §3.2.
+ * Any CRLF or LF immediately followed by a space or tab is removed.
+ * Tolerates LF-only line endings.
+ */
+export declare function unfoldLines(input: string): string[];
+/**
+ * Parse a single content line into a RawProperty.
+ * Returns null for BEGIN/END/VERSION lines (handled separately).
+ *
+ * Format: [group.]name[;param=value...]:value
+ */
+export declare function parseContentLine(line: string, warnings: ParseWarning[]): RawProperty | null;
+/**
+ * Convert a RawProperty to a typed Property instance.
+ * Unknown properties become UnknownProperty instances.
+ */
+export declare function instantiateProperty(raw: RawProperty, warnings: ParseWarning[]): Property;
+/** A raw parsed vCard block (list of content lines) */
+export interface RawVCard {
+    version: string;
+    properties: Property[];
+    warnings: ParseWarning[];
+}
+/** Result of parsing vCard text */
+export interface ParseResult {
+    rawVCards: RawVCard[];
+    warnings: ParseWarning[];
+}
+/**
+ * Parse vCard text into raw vCard blocks.
+ * Tolerates:
+ *   - Multiple vCards in one string
+ *   - CRLF or LF line endings
+ *   - Missing VERSION
+ *   - Unknown properties
+ *   - v3 syntax
+ */
+export declare function parseVCardText(input: string): ParseResult;
+//# sourceMappingURL=parser.d.ts.map