Release Contact Tools 0.2.0

tests/contact/model.test.ts

@@ -10,6 +10,12 @@ import {
   serializeVCards,
 } from "../../src/contact/model";
 import { contactQrPayload } from "../../src/contact/qr";
+import {
+  contactsFromJCard,
+  contactsFromJSContact,
+  contactsToJCard,
+  contactsToJSContact,
+} from "../../src/contact/interchange";
 
 const twoCards = `BEGIN:VCARD\r\nVERSION:3.0\r\nFN:Ada Lovelace\r\nN:Lovelace;Ada;;;\r\nEMAIL;TYPE=HOME,PREF:ada@example.test\r\nNOTE:one\r\n two\r\nEND:VCARD\r\nBEGIN:VCARD\r\nVERSION:4.0\r\nFN:Ada L. Lovelace\r\nN:Lovelace;Ada;L.;;\r\nEMAIL;PREF=1:ADA@example.test\r\nEND:VCARD\r\n`;
 
@@ -37,6 +43,30 @@ describe("vCard model", () => {
     expect(parseVCards(output).contacts[0]?.formattedName).toBe("Ada Lovelace");
   });
 
+  it("decodes vCard 2.1 values and preserves unknown grouped properties", () => {
+    const source = `BEGIN:VCARD\r\nVERSION:2.1\r\nFN;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:Andr=C3=A9=\r\n Example\r\nN:Example;André;;;\r\nitem1.EMAIL;TYPE=HOME:andre@example.test\r\nitem1.X-ABLabel:_$!<Home>!$_\r\nPHOTO;ENCODING=BASE64;TYPE=JPEG:/9j/2Q==\r\nEND:VCARD\r\n`;
+    const parsed = parseVCards(source);
+    expect(parsed.contacts[0]).toMatchObject({
+      version: "2.1",
+      formattedName: "André Example",
+    });
+    expect(parsed.contacts[0]?.emails[0]?.group).toBe("item1");
+    const label = parsed.contacts[0]?.preservedProperties.find(
+      (property) => property.name === "X-ABLABEL",
+    );
+    expect(label).toMatchObject({ group: "item1", rawValue: "_$!<Home>!$_" });
+    const photo = parsed.contacts[0]?.preservedProperties.find(
+      (property) => property.name === "PHOTO",
+    );
+    expect([...photo!.decodedBytes!]).toEqual([0xff, 0xd8, 0xff, 0xd9]);
+    const output = serializeVCards(parsed.contacts, "2.1");
+    expect(output).toContain("item1.X-ABLABEL:_$!<Home>!$_");
+    expect(output).toContain("PHOTO;ENCODING=BASE64;TYPE=JPEG:/9j/2Q==");
+    expect(parseVCards(output).contacts[0]?.formattedName).toBe(
+      "André Example",
+    );
+  });
+
   it("rejects incomplete and oversized inputs", () => {
     expect(() => parseVCards("BEGIN:VCARD\nFN:No end")).toThrow(/No complete/u);
     expect(() => parseVCards("x".repeat(2 * 1024 * 1024 + 1))).toThrow(
@@ -131,4 +161,50 @@ describe("vCard model", () => {
       contactQrPayload({ ...contact, note: "x".repeat(2_300) }),
     ).toThrow(/too large/u);
   });
+
+  it("maps broader RFC 6350 fields and preserves preference parameters", () => {
+    const source = `BEGIN:VCARD\r\nVERSION:4.0\r\nFN:Example Person\r\nN:Person;Example;;;\r\nKIND:individual\r\nNICKNAME:Ex,E.P.\r\nROLE:Architect\r\nANNIVERSARY:2020-02-03\r\nGENDER:F\r\nLANG;PREF=1:de\r\nTZ:Europe/Berlin\r\nGEO:geo:52.5,13.4\r\nIMPP;TYPE=work:xmpp:example@example.test\r\nRELATED;TYPE=friend:urn:uuid:friend\r\nMEMBER:urn:uuid:group-member\r\nPHOTO;VALUE=uri:https://example.test/photo.jpg\r\nEND:VCARD\r\n`;
+    const contact = parseVCards(source).contacts[0]!;
+    expect(contact).toMatchObject({
+      kind: "individual",
+      nicknames: ["Ex", "E.P."],
+      role: "Architect",
+      anniversary: "2020-02-03",
+      gender: "F",
+    });
+    expect(contact.languages[0]).toMatchObject({
+      value: "de",
+      preferred: true,
+    });
+    expect(contact.media[0]).toMatchObject({ kind: "PHOTO" });
+    const roundTrip = parseVCards(serializeVCards([contact])).contacts[0]!;
+    expect(roundTrip.instantMessaging[0]?.value).toBe(
+      "xmpp:example@example.test",
+    );
+    expect(roundTrip.members[0]?.value).toBe("urn:uuid:group-member");
+  });
+
+  it("round-trips structured jCard and focused JSContact cards", () => {
+    const contact = parseVCards(twoCards).contacts[0]!;
+    const jcard = contactsToJCard([contact]);
+    expect(jcard[0]?.[0]).toBe("vcard");
+    expect(contactsFromJCard(jcard)[0]).toMatchObject({
+      formattedName: "Ada Lovelace",
+      familyName: "Lovelace",
+      givenName: "Ada",
+    });
+
+    const jscontact = contactsToJSContact([contact]);
+    expect(jscontact.data[0]).toMatchObject({
+      "@type": "Card",
+      version: "1.0",
+    });
+    const imported = contactsFromJSContact(jscontact.data)[0]!;
+    expect(imported).toMatchObject({
+      formattedName: "Ada Lovelace",
+      familyName: "Lovelace",
+      givenName: "Ada",
+    });
+    expect(imported.emails[0]?.value).toBe("ada@example.test");
+  });
 });