@learncard/learn-card-plugin 1.2.26 → 1.2.27

package/dist/verificationPrettifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verificationPrettifier.d.ts","sourceRoot":"","sources":["../src/verificationPrettifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA0B,MAAM,kBAAkB,CAAC;AA+G5E,eAAO,MAAM,wBAAwB,SAAU,gBAAgB,KAAG,gBA6CjE,CAAC;AAEF,eAAO,MAAM,yBAAyB,UAAW,gBAAgB,EAAE,KAAG,gBAAgB,EAC/C,CAAC"}
+{"version":3,"file":"verificationPrettifier.d.ts","sourceRoot":"","sources":["../src/verificationPrettifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA0B,MAAM,kBAAkB,CAAC;AA8H5E,eAAO,MAAM,wBAAwB,SAAU,gBAAgB,KAAG,gBAmEjE,CAAC;AAEF,eAAO,MAAM,yBAAyB,UAAW,gBAAgB,EAAE,KAAG,gBAAgB,EAC/C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@learncard/learn-card-plugin",
-    "version": "1.2.26",
+    "version": "1.2.27",
     "description": "",
     "type": "module",
     "main": "./dist/index.cjs",
@@ -51,9 +51,9 @@
     },
     "types": "./dist/index.d.ts",
     "dependencies": {
-        "@learncard/core": "9.4.26",
-        "@learncard/didkit-plugin": "^1.9.6",
-        "@learncard/types": "5.17.5",
+        "@learncard/core": "9.4.27",
+        "@learncard/didkit-plugin": "^1.9.7",
+        "@learncard/types": "5.17.6",
         "date-fns": "^2.28.0"
     },
     "sideEffects": false

package/src/test/verificationPrettifier.test.ts

@@ -409,4 +409,80 @@ describe('verificationPrettifier', () => {
             expect(result.every(r => r.message && r.message !== r.check)).toBe(true);
         });
     });
+
+    describe('raw resolver / diagnostic failures (LC-1946)', () => {
+        it('maps an in-browser did:web resolution/fetch failure to friendly copy', () => {
+            const result = prettifyVerificationItem({
+                check:
+                    'Unable to filter proofs: Unable to resolve: Error sending HTTP request ' +
+                    '(https://participate.community/.well-known/did.json):',
+                message:
+                    'Unable to filter proofs: Unable to resolve: Error sending HTTP request ' +
+                    '(https://participate.community/.well-known/did.json): error sending request: ' +
+                    'JsValue(TypeError: Failed to fetch)',
+                status: VerificationStatusEnum.Failed,
+            });
+
+            expect(result.check).toBe('Issuer');
+            expect(result.message).toBe('Could not be reached');
+            // Raw diagnostic must not leak through message or details.
+            expect(result.message).not.toMatch(/fetch|resolve|http|did\.json/i);
+            expect(result.details).toBeUndefined();
+        });
+
+        it('maps a bare WASM/stack diagnostic to a generic friendly message', () => {
+            const result = prettifyVerificationItem({
+                check: 'proof',
+                message:
+                    'at https://staging.learncard.ai/assets/didkit_wasm.wasm:wasm-function[4263]:0x683',
+                status: VerificationStatusEnum.Failed,
+            });
+
+            expect(result.check).toBe('Verification');
+            expect(result.message).toBe('Could not be verified');
+            expect(result.message).not.toMatch(/wasm|assets|0x/i);
+        });
+
+        it('is idempotent on a mapped resolution failure', () => {
+            const raw = {
+                check: 'Unable to resolve',
+                message: 'Unable to resolve: Failed to fetch',
+                status: VerificationStatusEnum.Failed,
+            };
+            const once = prettifyVerificationItem(raw);
+            const twice = prettifyVerificationItem(once);
+            expect(twice).toEqual(once);
+            expect(once.message).toBe('Could not be reached');
+        });
+
+        it('does not touch a humanized non-resolver failure detail', () => {
+            const result = prettifyVerificationItem({
+                check: 'status',
+                details: 'Status: Revoked',
+                status: VerificationStatusEnum.Failed,
+            });
+            expect(result.details).toBe('Status: Revoked');
+            expect(result.check).toBe('status');
+        });
+
+        it('does not mislabel a humanized "Could not retrieve/resolve …" status detail as an issuer failure', () => {
+            const retrieve = prettifyVerificationItem({
+                check: 'revocation',
+                details: 'Could not retrieve revocation list',
+                status: VerificationStatusEnum.Failed,
+            });
+            expect(retrieve.check).toBe('revocation');
+            expect(retrieve.details).toBe('Could not retrieve revocation list');
+            expect(retrieve.check).not.toBe('Issuer');
+
+            const resolve = prettifyVerificationItem({
+                check: 'status',
+                details: 'Could not resolve credential status',
+                status: VerificationStatusEnum.Failed,
+            });
+            expect(resolve.check).toBe('status');
+            expect(resolve.details).toBe('Could not resolve credential status');
+            expect(resolve.check).not.toBe('Issuer');
+        });
+    });
 });

package/src/verificationPrettifier.ts

@@ -44,6 +44,21 @@ const ERROR_LABELS: Record<string, Label> = {
     internal_error: { check: 'Verification', message: 'Something went wrong' },
 };
 
+// Raw resolver / engine diagnostics that must never reach the UI. did:web verification
+// resolves the issuer's DID document via an in-browser fetch, which fails (CORS / offline)
+// with messages like "Unable to resolve: Error sending HTTP request (.../.well-known/did.json)
+// ... Failed to fetch ... wasm-function[...]". Map these to friendly copy instead.
+//
+// Kept deliberately specific to DID-document resolution/network noise. In particular we do
+// NOT match a bare "could not resolve/retrieve …", because that also appears in humanized,
+// already-readable status/revocation details (e.g. "Could not retrieve revocation list")
+// that must pass through untouched rather than be mislabeled as an issuer failure.
+const RESOLUTION_FAILURE_RE =
+    /unable to resolve|error sending (?:an? )?(?:http )?request|failed to fetch|well-known\/did\.json|dereferenc|network ?error/i;
+
+// Obvious raw stack / engine internals: WASM frames, JS source locations, JS error types.
+const RAW_DIAGNOSTIC_RE = /wasm-function|\bat https?:\/\/|\.js:\d+|\bJsValue\(|\bTypeError\b/i;
+
 const isAlreadyPrettified = (check: string | undefined): boolean => {
     if (!check) return true;
     return /^[A-Z]/.test(check) || /\s/.test(check);
@@ -118,7 +133,29 @@ export const prettifyVerificationItem = (item: VerificationItem): VerificationIt
         // (e.g. "signature_invalid: bad signature"), which the guard would
         // otherwise treat as already-prettified and skip.
         const code = resolveErrorCode(item);
-        if (!code) return item;
+        if (!code) {
+            // No known error code. Never surface raw resolver / WASM diagnostics to the user;
+            // map them to stable friendly copy. Anything else (e.g. a humanized "Status:
+            // Revoked" detail) passes through untouched.
+            const raw = [item.message, item.details, item.check].filter(Boolean).join(' ');
+            if (RESOLUTION_FAILURE_RE.test(raw)) {
+                return {
+                    ...item,
+                    check: 'Issuer',
+                    message: 'Could not be reached',
+                    details: undefined,
+                };
+            }
+            if (RAW_DIAGNOSTIC_RE.test(raw)) {
+                return {
+                    ...item,
+                    check: 'Verification',
+                    message: 'Could not be verified',
+                    details: undefined,
+                };
+            }
+            return item;
+        }
         const label = ERROR_LABELS[code];
 
         // The UI renders failed rows as `message ?? details`. If Layer 1