feat: add RFC 9537 redaction support, vCard address/fax parsing, and registrar address fields

- Parse the top-level RDAP `redacted` array (RFC 9537) into a new `redactions` field on `DomainRecord`; set `privacyEnabled` when any redaction references "registrant" - Expose `street`, `city`, `state`, `postalCode`, `country`, and `countryCode` on both `RegistrarInfo` and `Contact`; extract ISO 3166-1 alpha-2 from the vCard `cc` parameter (RFC 8605) - Split `tel` entries by fax type parameter (`"fax"` / `["work","fax"]`) into separate `tel` and `fax` lists; collect multiple email addresses as an array, collapsing singletons to a plain string - Prefer an exact `registration` event match over `reregistration` when extracting `creationDate` (RFC 9083) - Merge `redacted` arrays in `mergeRdapDocs`, deduplicating by JSON identity - Split `adr` street on `\r?\n` only (not commas) to avoid splitting inline comma-separated addresses
2026-09-23 01:25:31 -04:00 · 2026-09-19 23:01:30 -04:00
parent e77fc7f4ed
commit 386006dc61
6 changed files with 261 additions and 24 deletions
@@ -135,3 +135,135 @@ test("normalizeRdap treats release-pending statuses as not registered", () => {
  );
  expect(active.isRegistered).toBe(true);
 });
+
+test("normalizeRdap reads vCard adr cc parameter into countryCode", () => {
+  const rec = normalizeRdap(
+    "example.com",
+    "com",
+    {
+      ldhName: "example.com",
+      entities: [
+        {
+          roles: ["registrant"],
+          vcardArray: [
+            "vcard",
+            [["adr", { cc: "us" }, "text", ["", "", "1 Main St", "Town", "CA", "90000", "USA"]]],
+          ],
+        },
+      ],
+    },
+    [],
+  );
+  expect(rec.contacts?.[0]?.country).toBe("USA");
+  expect(rec.contacts?.[0]?.countryCode).toBe("US");
+});
+
+test("normalizeRdap parses RFC 9537 redacted array and flags privacy", () => {
+  const rec = normalizeRdap(
+    "example.com",
+    "com",
+    {
+      ldhName: "example.com",
+      redacted: [
+        {
+          name: { description: "Registrant Email" },
+          prePath: "$.entities[?(@.roles[0]=='registrant')].vcardArray[1][?(@[0]=='email')]",
+          method: "emptyValue",
+          reason: { description: "Server policy" },
+        },
+      ],
+    },
+    [],
+  );
+  expect(rec.redactions).toEqual([
+    expect.objectContaining({
+      name: "Registrant Email",
+      method: "emptyValue",
+      reason: "Server policy",
+    }),
+  ]);
+  expect(rec.privacyEnabled).toBe(true);
+});
+
+test("normalizeRdap separates fax from tel and keeps multiple emails", () => {
+  const rec = normalizeRdap(
+    "example.com",
+    "com",
+    {
+      ldhName: "example.com",
+      entities: [
+        {
+          roles: ["registrant"],
+          vcardArray: [
+            "vcard",
+            [
+              ["tel", { type: "voice" }, "text", "+1.111"],
+              ["tel", { type: ["work", "fax"] }, "text", "+1.222"],
+              ["email", {}, "text", "a@example.com"],
+              ["email", {}, "text", "b@example.com"],
+              ["adr", {}, "text", ["", "", "Suite 5, 1 Main St", "Town", "", "", ""]],
+            ],
+          ],
+        },
+      ],
+    },
+    [],
+  );
+  const c = rec.contacts?.[0];
+  expect(c?.phone).toBe("+1.111");
+  expect(c?.fax).toBe("+1.222");
+  expect(c?.email).toEqual(["a@example.com", "b@example.com"]);
+  expect(c?.street).toEqual(["Suite 5, 1 Main St"]);
+});
+
+test("normalizeRdap prefers registration event over reregistration", () => {
+  const rec = normalizeRdap(
+    "example.com",
+    "com",
+    {
+      ldhName: "example.com",
+      events: [
+        { eventAction: "reregistration", eventDate: "2024-01-01T00:00:00Z" },
+        { eventAction: "registration", eventDate: "2020-01-01T00:00:00Z" },
+      ],
+    },
+    [],
+  );
+  expect(rec.creationDate).toBe("2020-01-01T00:00:00Z");
+});
+
+test("normalizeRdap maps registrar adr and cc", () => {
+  const rec = normalizeRdap(
+    "example.com",
+    "com",
+    {
+      ldhName: "example.com",
+      entities: [
+        {
+          roles: ["registrar"],
+          vcardArray: [
+            "vcard",
+            [
+              ["fn", {}, "text", "Registrar LLC"],
+              [
+                "adr",
+                { cc: "CA" },
+                "text",
+                ["", "", "5 King St", "Toronto", "ON", "M5H", "Canada"],
+              ],
+            ],
+          ],
+        },
+      ],
+    },
+    [],
+  );
+  expect(rec.registrar).toMatchObject({
+    street: ["5 King St"],
+    city: "Toronto",
+    state: "ON",
+    postalCode: "M5H",
+    country: "Canada",
+    countryCode: "CA",
+  });
+});