Skip to content

Give email addresses their mailto identity - #133

Merged
jviotti merged 1 commit into
mainfrom
email-mailto-rdf
Aug 5, 2026
Merged

Give email addresses their mailto identity#133
jviotti merged 1 commit into
mainfrom
email-mailto-rdf

Conversation

@jviotti

@jviottijviotti commented Aug 5, 2026

Copy link
Copy Markdown
Member

Signed-off-by: Juan Cruz Viotti jv@jviotti.com

Review in cubic

Signed-off-by: Juan Cruz Viotti <jv@jviotti.com>
@jviotti
jviotti merged commit 415b1bd into mainAug 5, 2026
3 checks passed
@jviotti
jviotti deleted the email-mailto-rdf branch August 5, 2026 17:41
@augmentcode

Copy link
Copy Markdown
🤖 Augment PR Summary

Summary: This PR makes RFC 5321 email addresses carry a stable Linked Data identity by minting mailto: IRIs.

Changes:

  • Annotated the email address schema with x-jsonld-self: "mailto" so RDF/JSON-LD output uses mailto: identifiers
  • Added a new examples/contact-card.json schema demonstrating a person with email (mailto), account (acct), and website (URI) identities
  • Added example-level tests for the new contact card schema including expected RDF output
  • Expanded email address schema tests to assert minted mailto:@id values (including percent-encoding and domain normalization)
  • Bumped @sourcemeta/jsonschema dev dependency to ^16.6.0 to support/validate the new behavior

Technical Notes: The updated tests verify canonicalization behavior such as lowercasing the domain part and percent-encoding characters that are unsafe in a mailto IRI.

🤖 Was this summary useful? React with 👍 or 👎

@augmentcodeaugmentcodeBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. 2 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

"\"very.unusual.@.unusual.com\"@example.com",
"user@[IPv6:2001:db8::1]"
],
"x-jsonld-self": "mailto",

@augmentcodeaugmentcodeBotAug 5, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

schemas/ietf/email/5321/address/v1.json:11 — Since x-jsonld-self mints a mailto: IRI, consider also linking to RFC 6068 (mailto URI scheme) in x-links so the new identity semantics are documented alongside RFC 5321.

Severity: low

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

},
"account": {
"x-jsonld-id": "https://schema.org/identifier",
"x-jsonld-self": "acct",

@augmentcodeaugmentcodeBotAug 5, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

examples/contact-card.json:29 — account uses x-jsonld-self: "acct" but is otherwise unconstrained (type: "string"), so some values could validate yet still produce an invalid acct: IRI in RDF output. Consider constraining the allowed value space to inputs that are safe to embed as an acct identifier.

Severity: medium

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@jviotti