@nuggetslife/vc 0.0.30 → 0.2.0

package/test-fixtures/interop/nuggets/kyb-v1/expected.nq

@@ -0,0 +1,18 @@
+<did:example:test-company> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://schemas.nuggets.life/kybV1.json#Kyb> .
+<did:example:test-company> <https://schemas.nuggets.life/kybV1.json#result> _:c14n0 .
+<https://issuer.nuggets.life/credentials/kyb-v1/9876> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://schemas.nuggets.life/kybV1.json#KybCredential> .
+<https://issuer.nuggets.life/credentials/kyb-v1/9876> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://www.w3.org/2018/credentials#VerifiableCredential> .
+<https://issuer.nuggets.life/credentials/kyb-v1/9876> <https://www.w3.org/2018/credentials#credentialSubject> <did:example:test-company> .
+<https://issuer.nuggets.life/credentials/kyb-v1/9876> <https://www.w3.org/2018/credentials#issuanceDate> "2024-02-20T00:00:00Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
+<https://issuer.nuggets.life/credentials/kyb-v1/9876> <https://www.w3.org/2018/credentials#issuer> <did:example:nuggets-kyb-issuer> .
+_:c14n0 <https://schemas.nuggets.life/kybV1.json#businessInfo> _:c14n2 .
+_:c14n0 <https://schemas.nuggets.life/kybV1.json#director> _:c14n1 .
+_:c14n0 <https://schemas.nuggets.life/kybV1.json#director> _:c14n3 .
+_:c14n1 <http://schema.org/familyName> "JONES" .
+_:c14n1 <http://schema.org/givenName> "BOB" .
+_:c14n1 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://schemas.nuggets.life/kybV1.json#director> .
+_:c14n2 <http://schema.org/identifier> "12345678" .
+_:c14n2 <http://schema.org/name> "Test Limited" .
+_:c14n3 <http://schema.org/familyName> "SMITH" .
+_:c14n3 <http://schema.org/givenName> "ALICE" .
+_:c14n3 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://schemas.nuggets.life/kybV1.json#director> .

package/test-fixtures/interop/nuggets/kyb-v1/frame.jsonld

@@ -0,0 +1,24 @@
+{
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://schemas.nuggets.life/kybV1.json"
+  ],
+  "type": ["VerifiableCredential", "KybCredential"],
+  "credentialSubject": {
+    "@explicit": true,
+    "type": "Kyb",
+    "result": {
+      "@explicit": true,
+      "businessInfo": {
+        "@explicit": true,
+        "businessName": {},
+        "dunsNumber": {}
+      },
+      "director": [{
+        "@explicit": true,
+        "givenName": {},
+        "familyName": {}
+      }]
+    }
+  }
+}

package/test-fixtures/interop/nuggets/kyb-v1/input.jsonld

@@ -0,0 +1,60 @@
+{
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://schemas.nuggets.life/kybV1.json"
+  ],
+  "id": "https://issuer.nuggets.life/credentials/kyb-v1/9876",
+  "type": ["VerifiableCredential", "KybCredential"],
+  "issuer": "did:example:nuggets-kyb-issuer",
+  "issuanceDate": "2024-02-20T00:00:00Z",
+  "credentialSubject": {
+    "id": "did:example:test-company",
+    "type": "Kyb",
+    "result": {
+      "businessAddress": {
+        "country": "GB",
+        "address1": "1 Corporate Way",
+        "city": "London",
+        "region": "Greater London",
+        "postalCode": "EC1A 1AA"
+      },
+      "businessInfo": {
+        "businessName": "Test Limited",
+        "legalStatus": "Private Limited Company",
+        "dunsNumber": "12345678",
+        "domain": "test-limited.example"
+      },
+      "director": [
+        {
+          "type": "https://schemas.nuggets.life/kybV1.json#director",
+          "givenName": "ALICE",
+          "familyName": "SMITH",
+          "nationality": "GB"
+        },
+        {
+          "type": "https://schemas.nuggets.life/kybV1.json#director",
+          "givenName": "BOB",
+          "familyName": "JONES",
+          "nationality": "GB"
+        }
+      ],
+      "evidence": {
+        "duns": "DUN-12345678",
+        "registeredAddress": {
+          "addressCountry": {
+            "name": "United Kingdom",
+            "isoAlpha2Code": "GB"
+          },
+          "addressLocality": {
+            "name": "London"
+          },
+          "postalCode": "EC1A 1AA",
+          "streetAddress": {
+            "line1": "1 Corporate Way",
+            "line2": ""
+          }
+        }
+      }
+    }
+  }
+}

package/test-fixtures/interop/openbadges-v3/basic-achievement/README.md

@@ -0,0 +1,17 @@
+# OpenBadges v3 — basic-achievement
+
+Baseline OB v3 `OpenBadgeCredential` (a.k.a. `AchievementCredential`) wrapping a single `Achievement`. Adapted from the canonical IMS Global OB v3 spec example with synthetic data.
+
+- Upstream spec: `https://www.imsglobal.org/spec/ob/v3p0/`
+- Upstream context: `https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json`
+- Retrieval date: 2026-05-06
+
+## What this fixture exercises
+
+- OB v3 type-scoped contexts (`OpenBadgeCredential`, `AchievementSubject`, `Achievement`, `Profile`) layered on top of the W3C VC v1 base context.
+- A single-`Achievement` shape with `name` + `description` revealed via a BBS+-style frame (other achievement fields, the issuer's `Profile`, and the credential id stay hidden).
+- `criteria` modelled as a plain IRI reference (the upstream context types `criteria` as `@type: @id`).
+
+## Expected status
+
+**Pass.** This is the baseline; if it goes red, the OB v3 context bundle or the type-scoped layering itself is broken before we can meaningfully test `@list`/other features.

package/test-fixtures/interop/openbadges-v3/basic-achievement/expected.nq

@@ -0,0 +1,12 @@
+<did:example:ebfeb1f712ebc6f1c276e12ec21> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#AchievementSubject> .
+<did:example:ebfeb1f712ebc6f1c276e12ec21> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#achievement> <https://example.edu/achievements/sample-achievement> .
+<http://example.edu/credentials/3732> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#OpenBadgeCredential> .
+<http://example.edu/credentials/3732> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://www.w3.org/2018/credentials#VerifiableCredential> .
+<http://example.edu/credentials/3732> <https://www.w3.org/2018/credentials#credentialSubject> <did:example:ebfeb1f712ebc6f1c276e12ec21> .
+<http://example.edu/credentials/3732> <https://www.w3.org/2018/credentials#issuanceDate> "2020-04-01T00:00:00Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
+<http://example.edu/credentials/3732> <https://www.w3.org/2018/credentials#issuer> <https://example.edu/issuers/14> .
+<https://example.edu/achievements/sample-achievement> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#Achievement> .
+<https://example.edu/achievements/sample-achievement> <https://schema.org/description> "A simple achievement for interop testing." .
+<https://example.edu/achievements/sample-achievement> <https://schema.org/name> "Sample Achievement" .
+<https://example.edu/issuers/14> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#Profile> .
+<https://example.edu/issuers/14> <https://schema.org/name> "Example University" .

package/test-fixtures/interop/openbadges-v3/basic-achievement/frame.jsonld

@@ -0,0 +1,17 @@
+{
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json"
+  ],
+  "type": ["VerifiableCredential", "OpenBadgeCredential"],
+  "credentialSubject": {
+    "@explicit": true,
+    "type": "AchievementSubject",
+    "achievement": {
+      "@explicit": true,
+      "type": "Achievement",
+      "name": {},
+      "description": {}
+    }
+  }
+}

package/test-fixtures/interop/openbadges-v3/basic-achievement/input.jsonld

@@ -0,0 +1,25 @@
+{
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json"
+  ],
+  "id": "http://example.edu/credentials/3732",
+  "type": ["VerifiableCredential", "OpenBadgeCredential"],
+  "issuer": {
+    "id": "https://example.edu/issuers/14",
+    "type": "Profile",
+    "name": "Example University"
+  },
+  "issuanceDate": "2020-04-01T00:00:00Z",
+  "credentialSubject": {
+    "id": "did:example:ebfeb1f712ebc6f1c276e12ec21",
+    "type": "AchievementSubject",
+    "achievement": {
+      "id": "https://example.edu/achievements/sample-achievement",
+      "type": "Achievement",
+      "name": "Sample Achievement",
+      "description": "A simple achievement for interop testing.",
+      "criteria": "https://example.edu/criteria/pass-the-interop-test"
+    }
+  }
+}

package/test-fixtures/interop/openbadges-v3/with-allowed-values/README.md

@@ -0,0 +1,11 @@
+# OpenBadges v3 — with-allowed-values
+
+OpenBadges v3 `OpenBadgeCredential` containing a `ResultDescription` whose `allowedValue: ["F", "D", "C", "B", "A"]` is the only `@list`-typed field in the OB v3 3.0.3 context. The reveal frame discloses the achievement name + the result description's `allowedValue` list, so framing must preserve the list ordering and identity.
+
+This fixture exercises `@list` semantics specifically. If V2 native diverges from jsonld.js here, the gap is in `@list` handling — track in `interop-allowlist.json` with a Phase C issue.
+
+## Provenance
+
+- `input.jsonld`: synthetic, hand-authored against OB v3 3.0.3 schema.
+- `frame.jsonld`: BBS+-style selective disclosure.
+- `expected.nq`: regenerate with `node tools/regen_expected.mjs test-fixtures/interop/openbadges-v3/with-allowed-values` from `vc/js/`. Do not hand-edit.

package/test-fixtures/interop/openbadges-v3/with-allowed-values/expected.nq

@@ -0,0 +1,25 @@
+<did:example:s2> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#AchievementSubject> .
+<did:example:s2> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#achievement> <https://example.edu/achievements/grading-test> .
+<http://example.edu/credentials/4823> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#OpenBadgeCredential> .
+<http://example.edu/credentials/4823> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://www.w3.org/2018/credentials#VerifiableCredential> .
+<http://example.edu/credentials/4823> <https://www.w3.org/2018/credentials#credentialSubject> <did:example:s2> .
+<http://example.edu/credentials/4823> <https://www.w3.org/2018/credentials#issuanceDate> "2020-04-01T00:00:00Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
+<http://example.edu/credentials/4823> <https://www.w3.org/2018/credentials#issuer> <https://example.edu/issuers/14> .
+<https://example.edu/achievements/grading-test> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#Achievement> .
+<https://example.edu/achievements/grading-test> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#resultDescription> <https://example.edu/result-descriptions/letter-grade> .
+<https://example.edu/achievements/grading-test> <https://schema.org/name> "Letter-Graded Achievement" .
+<https://example.edu/issuers/14> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#Profile> .
+<https://example.edu/issuers/14> <https://schema.org/name> "Example University" .
+<https://example.edu/result-descriptions/letter-grade> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#ResultDescription> .
+<https://example.edu/result-descriptions/letter-grade> <https://purl.imsglobal.org/spec/vc/ob/vocab.html#allowedValue> _:c14n2 .
+<https://example.edu/result-descriptions/letter-grade> <https://schema.org/name> "Letter Grade" .
+_:c14n0 <http://www.w3.org/1999/02/22-rdf-syntax-ns#first> "B" .
+_:c14n0 <http://www.w3.org/1999/02/22-rdf-syntax-ns#rest> _:c14n4 .
+_:c14n1 <http://www.w3.org/1999/02/22-rdf-syntax-ns#first> "D" .
+_:c14n1 <http://www.w3.org/1999/02/22-rdf-syntax-ns#rest> _:c14n3 .
+_:c14n2 <http://www.w3.org/1999/02/22-rdf-syntax-ns#first> "F" .
+_:c14n2 <http://www.w3.org/1999/02/22-rdf-syntax-ns#rest> _:c14n1 .
+_:c14n3 <http://www.w3.org/1999/02/22-rdf-syntax-ns#first> "C" .
+_:c14n3 <http://www.w3.org/1999/02/22-rdf-syntax-ns#rest> _:c14n0 .
+_:c14n4 <http://www.w3.org/1999/02/22-rdf-syntax-ns#first> "A" .
+_:c14n4 <http://www.w3.org/1999/02/22-rdf-syntax-ns#rest> <http://www.w3.org/1999/02/22-rdf-syntax-ns#nil> .

package/test-fixtures/interop/openbadges-v3/with-allowed-values/frame.jsonld

@@ -0,0 +1,22 @@
+{
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json"
+  ],
+  "type": ["VerifiableCredential", "OpenBadgeCredential"],
+  "credentialSubject": {
+    "@explicit": true,
+    "type": "AchievementSubject",
+    "achievement": {
+      "@explicit": true,
+      "type": "Achievement",
+      "name": {},
+      "resultDescription": {
+        "@explicit": true,
+        "type": "ResultDescription",
+        "name": {},
+        "allowedValue": {}
+      }
+    }
+  }
+}

package/test-fixtures/interop/openbadges-v3/with-allowed-values/input.jsonld

@@ -0,0 +1,40 @@
+{
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json"
+  ],
+  "id": "http://example.edu/credentials/4823",
+  "type": ["VerifiableCredential", "OpenBadgeCredential"],
+  "issuer": {
+    "id": "https://example.edu/issuers/14",
+    "type": "Profile",
+    "name": "Example University"
+  },
+  "issuanceDate": "2020-04-01T00:00:00Z",
+  "credentialSubject": {
+    "id": "did:example:s2",
+    "type": "AchievementSubject",
+    "achievement": {
+      "id": "https://example.edu/achievements/grading-test",
+      "type": "Achievement",
+      "name": "Letter-Graded Achievement",
+      "criteria": { "narrative": "Earn at least a passing letter grade." },
+      "resultDescription": [
+        {
+          "id": "https://example.edu/result-descriptions/letter-grade",
+          "type": "ResultDescription",
+          "name": "Letter Grade",
+          "resultType": "LetterGrade",
+          "allowedValue": ["F", "D", "C", "B", "A"]
+        }
+      ]
+    },
+    "result": [
+      {
+        "type": "Result",
+        "resultDescription": "https://example.edu/result-descriptions/letter-grade",
+        "value": "A"
+      }
+    ]
+  }
+}

package/test-fixtures/interop/vp/single-vc-wrap/README.md

@@ -0,0 +1,6 @@
+# VerifiablePresentation — single VC wrap
+
+A VP wrapping one PermanentResidentCard. Tests that frame_native handles the canonical VP shape (`type: VerifiablePresentation` with a `verifiableCredential` array). This is the highest-risk Phase A fixture — VPs commonly trip the nested-graph regressions that V2 native doesn't yet handle.
+
+If this fixture goes green: VP-shaped credentials work cross-stack out of the box.
+If it fails: it's tracked in `interop-allowlist.json` and gets fixed in Phase C.

package/test-fixtures/interop/vp/single-vc-wrap/expected.nq

@@ -0,0 +1,7 @@
+<did:example:b34ca6cd37bbf23> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://schema.org/Person> _:c14n1 .
+<did:example:b34ca6cd37bbf23> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://w3id.org/citizenship#PermanentResident> _:c14n1 .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://w3id.org/citizenship#PermanentResidentCard> _:c14n1 .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://www.w3.org/2018/credentials#VerifiableCredential> _:c14n1 .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <https://www.w3.org/2018/credentials#credentialSubject> <did:example:b34ca6cd37bbf23> _:c14n1 .
+_:c14n0 <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://www.w3.org/2018/credentials#VerifiablePresentation> .
+_:c14n0 <https://www.w3.org/2018/credentials#verifiableCredential> _:c14n1 .

package/test-fixtures/interop/vp/single-vc-wrap/frame.jsonld

@@ -0,0 +1,17 @@
+{
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://w3id.org/citizenship/v1",
+    "https://w3id.org/security/bbs/v1"
+  ],
+  "type": "VerifiablePresentation",
+  "verifiableCredential": {
+    "@explicit": true,
+    "type": ["VerifiableCredential", "PermanentResidentCard"],
+    "credentialSubject": {
+      "@explicit": true,
+      "givenName": {},
+      "familyName": {}
+    }
+  }
+}

package/test-fixtures/interop/vp/single-vc-wrap/input.jsonld

@@ -0,0 +1,27 @@
+{
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://w3id.org/citizenship/v1",
+    "https://w3id.org/security/bbs/v1"
+  ],
+  "type": "VerifiablePresentation",
+  "verifiableCredential": [
+    {
+      "@context": [
+        "https://www.w3.org/2018/credentials/v1",
+        "https://w3id.org/citizenship/v1",
+        "https://w3id.org/security/bbs/v1"
+      ],
+      "id": "https://issuer.oidp.uscis.gov/credentials/83627465",
+      "type": ["VerifiableCredential", "PermanentResidentCard"],
+      "issuer": "did:example:489398593",
+      "issuanceDate": "2019-12-03T12:19:52Z",
+      "credentialSubject": {
+        "id": "did:example:b34ca6cd37bbf23",
+        "type": ["PermanentResident", "Person"],
+        "givenName": "JOHN",
+        "familyName": "SMITH"
+      }
+    }
+  ]
+}

package/test-fixtures/interop/w3c-vc-v1/permanent-resident-card/README.md

@@ -0,0 +1,5 @@
+# W3C VC v1.1 — PermanentResidentCard
+
+The reference fixture used end-to-end by `vc-rust-test` and the desktop / iOS / Android Detox suites. Source: W3C VC v1.1 spec example, with the W3C Citizenship + BBS+ contexts attached. The reveal frame discloses `givenName` + `familyName` only.
+
+This fixture is the **green baseline** — if the interop harness ever fails on this fixture, something has regressed at a fundamental level.

package/test-fixtures/interop/w3c-vc-v1/permanent-resident-card/expected.nq

@@ -0,0 +1,13 @@
+<did:example:b34ca6cd37bbf23> <http://schema.org/familyName> "SMITH" .
+<did:example:b34ca6cd37bbf23> <http://schema.org/givenName> "JOHN" .
+<did:example:b34ca6cd37bbf23> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://schema.org/Person> .
+<did:example:b34ca6cd37bbf23> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://w3id.org/citizenship#PermanentResident> .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <http://schema.org/description> "Government of Example Permanent Resident Card." .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <http://schema.org/identifier> "83627465" .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <http://schema.org/name> "Permanent Resident Card" .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://w3id.org/citizenship#PermanentResidentCard> .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://www.w3.org/2018/credentials#VerifiableCredential> .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <https://www.w3.org/2018/credentials#credentialSubject> <did:example:b34ca6cd37bbf23> .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <https://www.w3.org/2018/credentials#expirationDate> "2029-12-03T12:19:52Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <https://www.w3.org/2018/credentials#issuanceDate> "2019-12-03T12:19:52Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
+<https://issuer.oidp.uscis.gov/credentials/83627465> <https://www.w3.org/2018/credentials#issuer> <did:example:489398593> .

package/test-fixtures/interop/w3c-vc-v1/permanent-resident-card/frame.jsonld

@@ -0,0 +1,14 @@
+{
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://w3id.org/citizenship/v1",
+    "https://w3id.org/security/bbs/v1"
+  ],
+  "type": ["VerifiableCredential", "PermanentResidentCard"],
+  "credentialSubject": {
+    "@explicit": true,
+    "type": ["PermanentResident", "Person"],
+    "givenName": {},
+    "familyName": {}
+  }
+}

package/test-fixtures/interop/w3c-vc-v1/permanent-resident-card/input.jsonld

@@ -0,0 +1,29 @@
+{
+  "@context": [
+    "https://www.w3.org/2018/credentials/v1",
+    "https://w3id.org/citizenship/v1",
+    "https://w3id.org/security/bbs/v1"
+  ],
+  "id": "https://issuer.oidp.uscis.gov/credentials/83627465",
+  "type": ["VerifiableCredential", "PermanentResidentCard"],
+  "issuer": "did:example:489398593",
+  "identifier": "83627465",
+  "name": "Permanent Resident Card",
+  "description": "Government of Example Permanent Resident Card.",
+  "issuanceDate": "2019-12-03T12:19:52Z",
+  "expirationDate": "2029-12-03T12:19:52Z",
+  "credentialSubject": {
+    "id": "did:example:b34ca6cd37bbf23",
+    "type": ["PermanentResident", "Person"],
+    "givenName": "JOHN",
+    "familyName": "SMITH",
+    "gender": "Male",
+    "image": "data:image/png;base64,iVBORw0KGgokJggg==",
+    "residentSince": "2015-01-01",
+    "lprCategory": "C09",
+    "lprNumber": "999-999-999",
+    "commuterClassification": "C1",
+    "birthCountry": "Bahamas",
+    "birthDate": "1958-07-17"
+  }
+}

package/test_interop.mjs

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+// Cross-stack BBS+ interop test harness.
+//
+// For each fixture in `test-fixtures/interop/<family>/<name>/`:
+//   1. V2 native: JsonLd.frame(input, frame) → canonize → string
+//   2. Compare byte-equal against the fixture's `expected.nq` (committed
+//      ground truth, generated by `tools/regen_expected.mjs` from jsonld.js)
+//   3. Mismatch → REGRESSION, exit 1 (unless `expect_fail` allowlist matches —
+//      added in Task 5).
+//
+// Usage:
+//   node test_interop.mjs --check     (CI default)
+//   node test_interop.mjs --report    (local dev; prints diff per failure)
+
+import { readFileSync, existsSync, readdirSync, statSync } from 'node:fs';
+import { resolve, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { JsonLd } from './index.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const fixturesRoot = resolve(__dirname, 'test-fixtures', 'interop');
+const args = process.argv.slice(2);
+const checkMode = args.includes('--check');
+const reportMode = args.includes('--report');
+if (!checkMode && !reportMode) {
+  console.error('Usage: test_interop.mjs [--check | --report]');
+  process.exit(2);
+}
+
+const allowlistPath = resolve(__dirname, 'interop-allowlist.json');
+const allowlist = existsSync(allowlistPath)
+  ? JSON.parse(readFileSync(allowlistPath, 'utf8'))
+  : { expect_fail: [] };
+const expectFail = new Set((allowlist.expect_fail || []).map((e) => e.fixture));
+
+// Same offline loader shape as regen_expected.mjs. Loads bundled contexts
+// from `_contexts/` and surfaces them as additional contexts to JsonLd.
+function loadOfflineContexts() {
+  const dir = join(fixturesRoot, '_contexts');
+  const out = {};
+  if (!existsSync(dir)) return out;
+  for (const f of readdirSync(dir)) {
+    if (!f.endsWith('.jsonld') && !f.endsWith('.json')) continue;
+    const doc = JSON.parse(readFileSync(join(dir, f), 'utf8'));
+    if (!doc.__url__) continue;
+    const url = doc.__url__;
+    delete doc.__url__;
+    out[url] = doc;
+  }
+  return out;
+}
+
+function discoverFixtures(root) {
+  const out = [];
+  if (!existsSync(root)) return out;
+  for (const family of readdirSync(root).sort()) {
+    if (family.startsWith('_')) continue;
+    const familyDir = join(root, family);
+    if (!statSync(familyDir).isDirectory()) continue;
+    for (const name of readdirSync(familyDir).sort()) {
+      const fixtureDir = join(familyDir, name);
+      if (!statSync(fixtureDir).isDirectory()) continue;
+      out.push({ id: `${family}/${name}`, dir: fixtureDir });
+    }
+  }
+  return out;
+}
+
+function unifiedDiff(expected, actual, label) {
+  const e = expected.split('\n');
+  const a = actual.split('\n');
+  const max = Math.max(e.length, a.length);
+  const lines = [`--- expected.nq`, `+++ actual (V2 native, ${label})`];
+  for (let i = 0; i < max; i++) {
+    if (e[i] === a[i]) continue;
+    if (e[i] !== undefined) lines.push(`-${e[i]}`);
+    if (a[i] !== undefined) lines.push(`+${a[i]}`);
+  }
+  return lines.join('\n');
+}
+
+async function runFixture(fixture, contexts) {
+  const inputPath = join(fixture.dir, 'input.jsonld');
+  const framePath = join(fixture.dir, 'frame.jsonld');
+  const expectedPath = join(fixture.dir, 'expected.nq');
+  if (!existsSync(inputPath) || !existsSync(framePath) || !existsSync(expectedPath)) {
+    return { id: fixture.id, status: 'skip', reason: 'missing fixture file' };
+  }
+  const input = JSON.parse(readFileSync(inputPath, 'utf8'));
+  const frame = JSON.parse(readFileSync(framePath, 'utf8'));
+  const expected = readFileSync(expectedPath, 'utf8');
+
+  const proc = new JsonLd({ contexts });
+  let actual;
+  try {
+    const framed = await proc.frame(input, frame);
+    actual = await proc.canonize(framed, {
+      algorithm: 'URDNA2015',
+      format: 'application/n-quads',
+    });
+    if (typeof actual !== 'string') actual = String(actual);
+    if (!actual.endsWith('\n')) actual += '\n';
+  } catch (err) {
+    return { id: fixture.id, status: 'error', error: err.message || String(err) };
+  }
+  return {
+    id: fixture.id,
+    status: actual === expected ? 'pass' : 'fail',
+    expected,
+    actual,
+  };
+}
+
+async function main() {
+  const contexts = loadOfflineContexts();
+  const fixtures = discoverFixtures(fixturesRoot);
+  if (fixtures.length === 0) {
+    console.error(`no fixtures found under ${fixturesRoot}`);
+    process.exit(2);
+  }
+  const results = [];
+  for (const fx of fixtures) {
+    process.stderr.write(`  running ${fx.id}…\n`);
+    results.push(await runFixture(fx, contexts));
+  }
+  const pass = results.filter((r) => r.status === 'pass').length;
+  const fail = results.filter((r) => r.status === 'fail').length;
+  const error = results.filter((r) => r.status === 'error').length;
+  const skip = results.filter((r) => r.status === 'skip').length;
+
+  console.log(`\n========== INTEROP CONFORMANCE ==========`);
+  console.log(`pass:  ${pass}`);
+  console.log(`fail:  ${fail}`);
+  console.log(`error: ${error}`);
+  console.log(`skip:  ${skip}`);
+
+  const regressions = [];
+  const improvements = [];
+  const expectedFails = [];
+  const incomplete = [];
+  for (const r of results) {
+    if (r.status === 'pass') {
+      if (expectFail.has(r.id)) improvements.push(r);
+    } else if (r.status === 'fail' || r.status === 'error') {
+      if (expectFail.has(r.id)) expectedFails.push(r);
+      else regressions.push(r);
+    } else if (r.status === 'skip') {
+      incomplete.push(r);
+    }
+  }
+
+  if (reportMode) {
+    for (const r of [...regressions, ...expectedFails]) {
+      console.log(`\n--- ${r.id} (${r.status}${r.error ? ': ' + r.error : ''}) ---`);
+      if (r.expected !== undefined && r.actual !== undefined) {
+        const diff = unifiedDiff(r.expected, r.actual, r.id).split('\n').slice(0, 42).join('\n');
+        console.log(diff);
+      }
+    }
+    console.log(`\n[--report] ${regressions.length} divergence(s); ${expectedFails.length} expected-fail; ${improvements.length} improvement(s); ${incomplete.length} incomplete.`);
+    process.exit(0);
+  }
+
+  // --check mode
+  if (improvements.length) {
+    console.log(`\n${improvements.length} fixture(s) newly passing — please ratchet interop-allowlist.json:`);
+    for (const r of improvements) console.log(`  + ${r.id}`);
+    process.exit(1);
+  }
+  if (regressions.length) {
+    console.log(`\n${regressions.length} REGRESSION(S):`);
+    for (const r of regressions) console.log(`  - ${r.id} (${r.status}${r.error ? ': ' + r.error : ''})`);
+    process.exit(1);
+  }
+  if (incomplete.length) {
+    console.log(`\n${incomplete.length} incomplete fixture(s) — missing input.jsonld / frame.jsonld / expected.nq:`);
+    for (const r of incomplete) console.log(`  ! ${r.id}: ${r.reason || 'missing fixture file'}`);
+    console.log(`\nRun \`node tools/regen_expected.mjs <fixture-dir>\` to generate missing expected.nq.`);
+    process.exit(1);
+  }
+  console.log(`\nAll non-expect-fail fixtures match expected.nq.${expectedFails.length ? ' (' + expectedFails.length + ' tracked expect-fail.)' : ''}`);
+}
+
+main().catch((e) => { console.error(e); process.exit(1); });