@learncard/linked-claims-plugin 0.2.35 → 0.2.36

package/README.md

@@ -1,6 +1,6 @@
 # LinkedClaims Plugin
 
-Create, verify, store, and retrieve endorsement credentials using Open Badges v3 EndorsementCredential, linked to original credentials by subject id or original credential id.
+Create, verify, store, and retrieve endorsement credentials using Open Badges v3 EndorsementCredential, linked to each original credential by its unique top-level id.
 
 ## Install
 
@@ -20,10 +20,13 @@ const lc = await LearnCard.fromSomewhere().then(lc => lc.addPlugin(getLinkedClai
 const endorsement = await lc.invoke.endorseCredential(originalVc, {
     // OBv3 fields
     endorsementComment: 'I endorse this credential.',
-    name: `Endorsement of ${originalVc.id ?? originalVc.credentialSubject?.id}`,
+    name: 'Endorsement of First Aid',
     description: 'Peer endorsement',
 });
 
+// The original credential must have a unique top-level id. A holder DID in
+// credentialSubject.id does not identify a specific credential.
+
 const verified = await lc.invoke.verifyEndorsement(endorsement);
 
 const { uri } = await lc.invoke.storeEndorsement(endorsement);
@@ -44,6 +47,6 @@ Uses VC v2 and OBv3 contexts:
 
 ### Endorsement Fields (details input)
 
--   `endorsementComment?: string`
--   `name?: string`
--   `description?: string`
+- `endorsementComment?: string`
+- `name?: string`
+- `description?: string`

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,kCAAkC,EAAE,MAAM,SAAS,CAAC;AAEtF,cAAc,SAAS,CAAC;AA8BxB,eAAO,MAAM,qBAAqB,GAC9B,WAAW,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,EAAE,kCAAkC,CAAC,KACjG,kBA+ID,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,kCAAkC,EAAE,MAAM,SAAS,CAAC;AAEtF,cAAc,SAAS,CAAC;AAwBxB,eAAO,MAAM,qBAAqB,GAC9B,WAAW,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,EAAE,kCAAkC,CAAC,KACjG,kBA2ID,CAAC"}

package/dist/linked-claims-plugin.cjs.development.cjs

@@ -25,11 +25,6 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var ENDORSEMENT_CONTEXT = "https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json";
-var getSubjectIds = /* @__PURE__ */ __name((credential) => {
-  const subject = credential.credentialSubject;
-  if (Array.isArray(subject)) return subject.map((s) => s?.id).filter(Boolean);
-  return subject?.id ? [subject.id] : [];
-}, "getSubjectIds");
 var pickIndexProvider = /* @__PURE__ */ __name((learnCard, preferred) => {
   const providers = Object.keys(learnCard.index || {}).filter(
     (k) => !["providers", "all"].includes(k)
@@ -53,11 +48,8 @@ var getLinkedClaimsPlugin = /* @__PURE__ */ __name((learnCard) => ({
   methods: {
     endorseCredential: /* @__PURE__ */ __name(async (_learnCard, original, details, opts) => {
       const issuer = learnCard.id.did();
-      const originalId = original.id;
-      const subjectIds = getSubjectIds(original);
-      const targetId = originalId || subjectIds[0];
-      if (!targetId)
-        throw new Error("Original credential must have either id or credentialSubject.id");
+      const targetId = original.id;
+      if (!targetId) throw new Error("Original credential must have an id");
       const context = [
         "https://www.w3.org/ns/credentials/v2",
         ENDORSEMENT_CONTEXT
@@ -133,8 +125,8 @@ var getLinkedClaimsPlugin = /* @__PURE__ */ __name((learnCard) => ({
           originalCredentialId: csObj?.id,
           issuedOn: endorsement.validFrom || endorsement.issuanceDate,
           category: "Endorsement",
-          credentialId: options?.credentialId,
-          // original credential id
+          title: endorsement.name,
+          credentialId: options?.credentialId ?? csObj?.id,
           sharedUri: options?.sharedUri,
           // original credential shared uri
           relationship: options?.relationship,
@@ -147,9 +139,8 @@ var getLinkedClaimsPlugin = /* @__PURE__ */ __name((learnCard) => ({
     getEndorsements: /* @__PURE__ */ __name(async (_learnCard, original, options) => {
       const indexName = pickIndexProvider(learnCard, options?.indexName);
       if (!indexName) return [];
-      const subjectIds = getSubjectIds(original);
-      const originalId = original.id;
-      const query = originalId ? { originalCredentialId: originalId } : { endorsedId: subjectIds[0] };
+      if (!original.id) return [];
+      const query = { originalCredentialId: original.id };
       const records = await learnCard.index[indexName].get(query);
       const results = [];
       for (const rec of records) {

package/dist/linked-claims-plugin.cjs.development.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["import type { LearnCard } from '@learncard/core';\nimport type { VC, UnsignedVC } from '@learncard/types';\nimport type { LinkedClaimsPlugin, LinkedClaimsPluginDependentMethods } from './types';\n\nexport * from './types';\n\nconst ENDORSEMENT_CONTEXT = 'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json';\n\nconst getSubjectIds = (credential: VC): string[] => {\n    const subject = credential.credentialSubject as any;\n    if (Array.isArray(subject)) return subject.map(s => s?.id).filter(Boolean);\n    return subject?.id ? [subject.id] : [];\n};\n\nconst pickIndexProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.index || {}).filter(\n        k => !['providers', 'all'].includes(k)\n    );\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    if (providers.includes('LearnCloud')) return 'LearnCloud';\n    return providers[0];\n};\n\nconst pickStoreProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.store || {}).filter(k => k !== 'providers');\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    return providers[0];\n};\n\nconst ensureArray = <T>(arr: T | T[] | undefined): T[] =>\n    Array.isArray(arr) ? arr : arr ? [arr] : [];\n\nexport const getLinkedClaimsPlugin = (\n    learnCard: LearnCard<any, 'id' | 'store' | 'index' | 'read', LinkedClaimsPluginDependentMethods>\n): LinkedClaimsPlugin => ({\n    name: 'LinkedClaims',\n    displayName: 'LinkedClaims',\n    description: 'Create, verify, store, and retrieve endorsement credentials linked to originals.',\n    methods: {\n        endorseCredential: async (_learnCard, original, details, opts) => {\n            const issuer = learnCard.id.did();\n\n            const originalId: string | undefined = (original as any).id;\n            const subjectIds = getSubjectIds(original);\n            const targetId = originalId || subjectIds[0];\n            if (!targetId)\n                throw new Error('Original credential must have either id or credentialSubject.id');\n\n            const context: (string | Record<string, any>)[] = [\n                'https://www.w3.org/ns/credentials/v2',\n                ENDORSEMENT_CONTEXT,\n            ];\n\n            const types: [string, ...string[]] = ['VerifiableCredential', 'EndorsementCredential'];\n\n            const unsigned: UnsignedVC = {\n                '@context': context as any,\n                type: types,\n                issuer,\n                validFrom: new Date().toISOString(),\n                credentialSubject: {\n                    type: ['EndorsementSubject'],\n                    id: targetId,\n                    ...(details.endorsementComment\n                        ? { endorsementComment: details.endorsementComment }\n                        : {}),\n                },\n                ...(details.name ? { name: details.name } : { name: `Endorsement of ${targetId}` }),\n                ...(details.description ? { description: details.description } : {}),\n                ...(details.evidence && { evidence: details.evidence as any }),\n            };\n\n            return learnCard.invoke.issueCredential(unsigned);\n        },\n\n        verifyEndorsement: async (_learnCard, endorsement, options) => {\n            const check = await learnCard.invoke.verifyCredential(endorsement, options);\n\n            const ctx = ensureArray((endorsement as any)['@context']);\n            const types = ensureArray((endorsement as any)['type']);\n\n            if (\n                !ctx.some((c: string) => c === 'https://www.w3.org/ns/credentials/v2') ||\n                !ctx.some((c: string) => c === ENDORSEMENT_CONTEXT)\n            ) {\n                check.errors.push('linked-claims error: missing VCv2 or OBv3 context');\n            }\n            if (!types.includes('EndorsementCredential')) {\n                check.errors.push('linked-claims error: missing EndorsementCredential type');\n            }\n\n            const cs: any = (endorsement as any).credentialSubject;\n            const csObj = Array.isArray(cs) ? cs[0] : cs;\n            const csTypes = ensureArray<string>(csObj?.type);\n            if (!csTypes.includes('EndorsementSubject')) {\n                check.errors.push(\n                    'linked-claims error: credentialSubject.type must include EndorsementSubject'\n                );\n            }\n            if (!csObj?.id) {\n                check.errors.push('linked-claims error: credentialSubject.id missing');\n            }\n\n            if (!check.errors.length) check.checks.push('linked-claims');\n            return check;\n        },\n\n        storeEndorsement: async (_learnCard, endorsement, options) => {\n            const storeName = pickStoreProvider(learnCard, options?.storeName);\n            if (!storeName) throw new Error('No store plane provider available');\n            if (\n                !learnCard.store[storeName].uploadEncrypted ||\n                typeof learnCard.store[storeName].uploadEncrypted !== 'function'\n            ) {\n                throw new Error(\n                    `Store provider '${storeName}' does not support uploadEncrypted method`\n                );\n            }\n            const uri: string = await (learnCard.store as any)[storeName].uploadEncrypted(\n                endorsement\n            );\n\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            let indexed = false;\n            let id =\n                (endorsement as any).id ||\n                `urn:uuid:${(globalThis as any).crypto?.randomUUID?.() ||\n                (() => {\n                    throw new Error(\n                        'Secure random UUID generation is not available. Please use an environment that supports crypto.randomUUID().'\n                    );\n                })()\n                }`;\n\n            if (indexName) {\n                const cs: any = (endorsement as any).credentialSubject;\n                const csObj = Array.isArray(cs) ? cs[0] : cs;\n                const record = {\n                    id,\n                    uri,\n                    type: ensureArray((endorsement as any).type),\n                    endorsedId: csObj?.id,\n                    subjectId: csObj?.id,\n                    originalCredentialId: csObj?.id,\n                    issuedOn: (endorsement as any).validFrom || (endorsement as any).issuanceDate,\n                    category: 'Endorsement',\n                    credentialId: options?.credentialId, // original credential id\n                    sharedUri: options?.sharedUri, // original credential shared uri\n                    relationship: options?.relationship,\n                    visibility: options?.visibility ?? 'public',\n                };\n                indexed = await (learnCard.index as any)[indexName].add(record);\n            }\n\n            return { uri, indexed, id, indexName, storeName };\n        },\n\n        getEndorsements: async (_learnCard, original, options) => {\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            if (!indexName) return [];\n\n            const subjectIds = getSubjectIds(original);\n            const originalId = (original as any).id;\n\n            const query = originalId\n                ? { originalCredentialId: originalId }\n                : { endorsedId: subjectIds[0] };\n            const records = await (learnCard.index as any)[indexName].get(query);\n\n            const results: VC[] = [];\n            for (const rec of records) {\n                const vc = await learnCard.read.get(rec.uri);\n                if (vc) results.push(vc as VC);\n            }\n            return results;\n        },\n    },\n});\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { LearnCard } from '@learncard/core';\nimport type { VC, UnsignedVC } from '@learncard/types';\nimport type { LinkedClaimsPlugin, LinkedClaimsPluginDependentMethods } from './types';\n\nexport * from './types';\n\nconst ENDORSEMENT_CONTEXT = 'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json';\n\nconst pickIndexProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.index || {}).filter(\n        k => !['providers', 'all'].includes(k)\n    );\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    if (providers.includes('LearnCloud')) return 'LearnCloud';\n    return providers[0];\n};\n\nconst pickStoreProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.store || {}).filter(k => k !== 'providers');\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    return providers[0];\n};\n\nconst ensureArray = <T>(arr: T | T[] | undefined): T[] =>\n    Array.isArray(arr) ? arr : arr ? [arr] : [];\n\nexport const getLinkedClaimsPlugin = (\n    learnCard: LearnCard<any, 'id' | 'store' | 'index' | 'read', LinkedClaimsPluginDependentMethods>\n): LinkedClaimsPlugin => ({\n    name: 'LinkedClaims',\n    displayName: 'LinkedClaims',\n    description: 'Create, verify, store, and retrieve endorsement credentials linked to originals.',\n    methods: {\n        endorseCredential: async (_learnCard, original, details, opts) => {\n            const issuer = learnCard.id.did();\n\n            const targetId = original.id;\n            if (!targetId) throw new Error('Original credential must have an id');\n\n            const context: (string | Record<string, any>)[] = [\n                'https://www.w3.org/ns/credentials/v2',\n                ENDORSEMENT_CONTEXT,\n            ];\n\n            const types: [string, ...string[]] = ['VerifiableCredential', 'EndorsementCredential'];\n\n            const unsigned: UnsignedVC = {\n                '@context': context as any,\n                type: types,\n                issuer,\n                validFrom: new Date().toISOString(),\n                credentialSubject: {\n                    type: ['EndorsementSubject'],\n                    id: targetId,\n                    ...(details.endorsementComment\n                        ? { endorsementComment: details.endorsementComment }\n                        : {}),\n                },\n                ...(details.name ? { name: details.name } : { name: `Endorsement of ${targetId}` }),\n                ...(details.description ? { description: details.description } : {}),\n                ...(details.evidence && { evidence: details.evidence as any }),\n            };\n\n            return learnCard.invoke.issueCredential(unsigned);\n        },\n\n        verifyEndorsement: async (_learnCard, endorsement, options) => {\n            const check = await learnCard.invoke.verifyCredential(endorsement, options);\n\n            const ctx = ensureArray((endorsement as any)['@context']);\n            const types = ensureArray((endorsement as any)['type']);\n\n            if (\n                !ctx.some((c: string) => c === 'https://www.w3.org/ns/credentials/v2') ||\n                !ctx.some((c: string) => c === ENDORSEMENT_CONTEXT)\n            ) {\n                check.errors.push('linked-claims error: missing VCv2 or OBv3 context');\n            }\n            if (!types.includes('EndorsementCredential')) {\n                check.errors.push('linked-claims error: missing EndorsementCredential type');\n            }\n\n            const cs: any = (endorsement as any).credentialSubject;\n            const csObj = Array.isArray(cs) ? cs[0] : cs;\n            const csTypes = ensureArray<string>(csObj?.type);\n            if (!csTypes.includes('EndorsementSubject')) {\n                check.errors.push(\n                    'linked-claims error: credentialSubject.type must include EndorsementSubject'\n                );\n            }\n            if (!csObj?.id) {\n                check.errors.push('linked-claims error: credentialSubject.id missing');\n            }\n\n            if (!check.errors.length) check.checks.push('linked-claims');\n            return check;\n        },\n\n        storeEndorsement: async (_learnCard, endorsement, options) => {\n            const storeName = pickStoreProvider(learnCard, options?.storeName);\n            if (!storeName) throw new Error('No store plane provider available');\n            if (\n                !learnCard.store[storeName].uploadEncrypted ||\n                typeof learnCard.store[storeName].uploadEncrypted !== 'function'\n            ) {\n                throw new Error(\n                    `Store provider '${storeName}' does not support uploadEncrypted method`\n                );\n            }\n            const uri: string = await (learnCard.store as any)[storeName].uploadEncrypted(\n                endorsement\n            );\n\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            let indexed = false;\n            // prettier-ignore\n            let id =\n                (endorsement as any).id ||\n                `urn:uuid:${globalThis.crypto?.randomUUID?.() ||\n                (() => {\n                    throw new Error(\n                        'Secure random UUID generation is not available. Please use an environment that supports crypto.randomUUID().'\n                    );\n                })()\n                }`;\n\n            if (indexName) {\n                const cs: any = (endorsement as any).credentialSubject;\n                const csObj = Array.isArray(cs) ? cs[0] : cs;\n                const record = {\n                    id,\n                    uri,\n                    type: ensureArray((endorsement as any).type),\n                    endorsedId: csObj?.id,\n                    subjectId: csObj?.id,\n                    originalCredentialId: csObj?.id,\n                    issuedOn: (endorsement as any).validFrom || (endorsement as any).issuanceDate,\n                    category: 'Endorsement',\n                    title: endorsement.name,\n                    credentialId: options?.credentialId ?? csObj?.id,\n                    sharedUri: options?.sharedUri, // original credential shared uri\n                    relationship: options?.relationship,\n                    visibility: options?.visibility ?? 'public',\n                };\n                indexed = await (learnCard.index as any)[indexName].add(record);\n            }\n\n            return { uri, indexed, id, indexName, storeName };\n        },\n\n        getEndorsements: async (_learnCard, original, options) => {\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            if (!indexName) return [];\n\n            if (!original.id) return [];\n\n            const query = { originalCredentialId: original.id };\n            const records = await (learnCard.index as any)[indexName].get(query);\n\n            const results: VC[] = [];\n            for (const rec of records) {\n                const vc = await learnCard.read.get(rec.uri);\n                if (vc) results.push(vc as VC);\n            }\n            return results;\n        },\n    },\n});\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/linked-claims-plugin.cjs.production.min.cjs

@@ -1,2 +1,2 @@
-"use strict";var p=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var b=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var c=(e,t)=>p(e,"name",{value:t,configurable:!0});var E=(e,t)=>{for(var n in t)p(e,n,{get:t[n],enumerable:!0})},w=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of b(t))!C.call(e,i)&&i!==n&&p(e,i,{get:()=>t[i],enumerable:!(r=h(t,i))||r.enumerable});return e};var k=e=>w(p({},"__esModule",{value:!0}),e);var I={};E(I,{getLinkedClaimsPlugin:()=>x});module.exports=k(I);var g="https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json",f=c(e=>{let t=e.credentialSubject;return Array.isArray(t)?t.map(n=>n?.id).filter(Boolean):t?.id?[t.id]:[]},"getSubjectIds"),v=c((e,t)=>{let n=Object.keys(e.index||{}).filter(r=>!["providers","all"].includes(r));if(n.length)return t&&n.includes(t)?t:n.includes("LearnCloud")?"LearnCloud":n[0]},"pickIndexProvider"),j=c((e,t)=>{let n=Object.keys(e.store||{}).filter(r=>r!=="providers");if(n.length)return t&&n.includes(t)?t:n[0]},"pickStoreProvider"),m=c(e=>Array.isArray(e)?e:e?[e]:[],"ensureArray"),x=c(e=>({name:"LinkedClaims",displayName:"LinkedClaims",description:"Create, verify, store, and retrieve endorsement credentials linked to originals.",methods:{endorseCredential:c(async(t,n,r,i)=>{let l=e.id.did(),o=n.id,d=f(n),s=o||d[0];if(!s)throw new Error("Original credential must have either id or credentialSubject.id");let y={"@context":["https://www.w3.org/ns/credentials/v2",g],type:["VerifiableCredential","EndorsementCredential"],issuer:l,validFrom:new Date().toISOString(),credentialSubject:{type:["EndorsementSubject"],id:s,...r.endorsementComment?{endorsementComment:r.endorsementComment}:{}},...r.name?{name:r.name}:{name:`Endorsement of ${s}`},...r.description?{description:r.description}:{},...r.evidence&&{evidence:r.evidence}};return e.invoke.issueCredential(y)},"endorseCredential"),verifyEndorsement:c(async(t,n,r)=>{let i=await e.invoke.verifyCredential(n,r),l=m(n["@context"]),o=m(n.type);(!l.some(a=>a==="https://www.w3.org/ns/credentials/v2")||!l.some(a=>a===g))&&i.errors.push("linked-claims error: missing VCv2 or OBv3 context"),o.includes("EndorsementCredential")||i.errors.push("linked-claims error: missing EndorsementCredential type");let d=n.credentialSubject,s=Array.isArray(d)?d[0]:d;return m(s?.type).includes("EndorsementSubject")||i.errors.push("linked-claims error: credentialSubject.type must include EndorsementSubject"),s?.id||i.errors.push("linked-claims error: credentialSubject.id missing"),i.errors.length||i.checks.push("linked-claims"),i},"verifyEndorsement"),storeEndorsement:c(async(t,n,r)=>{let i=j(e,r?.storeName);if(!i)throw new Error("No store plane provider available");if(!e.store[i].uploadEncrypted||typeof e.store[i].uploadEncrypted!="function")throw new Error(`Store provider '${i}' does not support uploadEncrypted method`);let l=await e.store[i].uploadEncrypted(n),o=v(e,r?.indexName),d=!1,s=n.id||`urn:uuid:${globalThis.crypto?.randomUUID?.()||(()=>{throw new Error("Secure random UUID generation is not available. Please use an environment that supports crypto.randomUUID().")})()}`;if(o){let u=n.credentialSubject,a=Array.isArray(u)?u[0]:u,y={id:s,uri:l,type:m(n.type),endorsedId:a?.id,subjectId:a?.id,originalCredentialId:a?.id,issuedOn:n.validFrom||n.issuanceDate,category:"Endorsement",credentialId:r?.credentialId,sharedUri:r?.sharedUri,relationship:r?.relationship,visibility:r?.visibility??"public"};d=await e.index[o].add(y)}return{uri:l,indexed:d,id:s,indexName:o,storeName:i}},"storeEndorsement"),getEndorsements:c(async(t,n,r)=>{let i=v(e,r?.indexName);if(!i)return[];let l=f(n),o=n.id,d=o?{originalCredentialId:o}:{endorsedId:l[0]},s=await e.index[i].get(d),u=[];for(let a of s){let y=await e.read.get(a.uri);y&&u.push(y)}return u},"getEndorsements")}}),"getLinkedClaimsPlugin");
+"use strict";var y=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var c=(e,i)=>y(e,"name",{value:i,configurable:!0});var E=(e,i)=>{for(var n in i)y(e,n,{get:i[n],enumerable:!0})},b=(e,i,n,r)=>{if(i&&typeof i=="object"||typeof i=="function")for(let t of h(i))!C.call(e,t)&&t!==n&&y(e,t,{get:()=>i[t],enumerable:!(r=v(i,t))||r.enumerable});return e};var w=e=>b(y({},"__esModule",{value:!0}),e);var j={};E(j,{getLinkedClaimsPlugin:()=>x});module.exports=w(j);var m="https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json",g=c((e,i)=>{let n=Object.keys(e.index||{}).filter(r=>!["providers","all"].includes(r));if(n.length)return i&&n.includes(i)?i:n.includes("LearnCloud")?"LearnCloud":n[0]},"pickIndexProvider"),k=c((e,i)=>{let n=Object.keys(e.store||{}).filter(r=>r!=="providers");if(n.length)return i&&n.includes(i)?i:n[0]},"pickStoreProvider"),p=c(e=>Array.isArray(e)?e:e?[e]:[],"ensureArray"),x=c(e=>({name:"LinkedClaims",displayName:"LinkedClaims",description:"Create, verify, store, and retrieve endorsement credentials linked to originals.",methods:{endorseCredential:c(async(i,n,r,t)=>{let d=e.id.did(),s=n.id;if(!s)throw new Error("Original credential must have an id");let a={"@context":["https://www.w3.org/ns/credentials/v2",m],type:["VerifiableCredential","EndorsementCredential"],issuer:d,validFrom:new Date().toISOString(),credentialSubject:{type:["EndorsementSubject"],id:s,...r.endorsementComment?{endorsementComment:r.endorsementComment}:{}},...r.name?{name:r.name}:{name:`Endorsement of ${s}`},...r.description?{description:r.description}:{},...r.evidence&&{evidence:r.evidence}};return e.invoke.issueCredential(a)},"endorseCredential"),verifyEndorsement:c(async(i,n,r)=>{let t=await e.invoke.verifyCredential(n,r),d=p(n["@context"]),s=p(n.type);(!d.some(u=>u==="https://www.w3.org/ns/credentials/v2")||!d.some(u=>u===m))&&t.errors.push("linked-claims error: missing VCv2 or OBv3 context"),s.includes("EndorsementCredential")||t.errors.push("linked-claims error: missing EndorsementCredential type");let o=n.credentialSubject,l=Array.isArray(o)?o[0]:o;return p(l?.type).includes("EndorsementSubject")||t.errors.push("linked-claims error: credentialSubject.type must include EndorsementSubject"),l?.id||t.errors.push("linked-claims error: credentialSubject.id missing"),t.errors.length||t.checks.push("linked-claims"),t},"verifyEndorsement"),storeEndorsement:c(async(i,n,r)=>{let t=k(e,r?.storeName);if(!t)throw new Error("No store plane provider available");if(!e.store[t].uploadEncrypted||typeof e.store[t].uploadEncrypted!="function")throw new Error(`Store provider '${t}' does not support uploadEncrypted method`);let d=await e.store[t].uploadEncrypted(n),s=g(e,r?.indexName),o=!1,l=n.id||`urn:uuid:${globalThis.crypto?.randomUUID?.()||(()=>{throw new Error("Secure random UUID generation is not available. Please use an environment that supports crypto.randomUUID().")})()}`;if(s){let a=n.credentialSubject,u=Array.isArray(a)?a[0]:a,f={id:l,uri:d,type:p(n.type),endorsedId:u?.id,subjectId:u?.id,originalCredentialId:u?.id,issuedOn:n.validFrom||n.issuanceDate,category:"Endorsement",title:n.name,credentialId:r?.credentialId??u?.id,sharedUri:r?.sharedUri,relationship:r?.relationship,visibility:r?.visibility??"public"};o=await e.index[s].add(f)}return{uri:d,indexed:o,id:l,indexName:s,storeName:t}},"storeEndorsement"),getEndorsements:c(async(i,n,r)=>{let t=g(e,r?.indexName);if(!t)return[];if(!n.id)return[];let d={originalCredentialId:n.id},s=await e.index[t].get(d),o=[];for(let l of s){let a=await e.read.get(l.uri);a&&o.push(a)}return o},"getEndorsements")}}),"getLinkedClaimsPlugin");
 //# sourceMappingURL=linked-claims-plugin.cjs.production.min.cjs.map

package/dist/linked-claims-plugin.cjs.production.min.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["import type { LearnCard } from '@learncard/core';\nimport type { VC, UnsignedVC } from '@learncard/types';\nimport type { LinkedClaimsPlugin, LinkedClaimsPluginDependentMethods } from './types';\n\nexport * from './types';\n\nconst ENDORSEMENT_CONTEXT = 'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json';\n\nconst getSubjectIds = (credential: VC): string[] => {\n    const subject = credential.credentialSubject as any;\n    if (Array.isArray(subject)) return subject.map(s => s?.id).filter(Boolean);\n    return subject?.id ? [subject.id] : [];\n};\n\nconst pickIndexProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.index || {}).filter(\n        k => !['providers', 'all'].includes(k)\n    );\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    if (providers.includes('LearnCloud')) return 'LearnCloud';\n    return providers[0];\n};\n\nconst pickStoreProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.store || {}).filter(k => k !== 'providers');\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    return providers[0];\n};\n\nconst ensureArray = <T>(arr: T | T[] | undefined): T[] =>\n    Array.isArray(arr) ? arr : arr ? [arr] : [];\n\nexport const getLinkedClaimsPlugin = (\n    learnCard: LearnCard<any, 'id' | 'store' | 'index' | 'read', LinkedClaimsPluginDependentMethods>\n): LinkedClaimsPlugin => ({\n    name: 'LinkedClaims',\n    displayName: 'LinkedClaims',\n    description: 'Create, verify, store, and retrieve endorsement credentials linked to originals.',\n    methods: {\n        endorseCredential: async (_learnCard, original, details, opts) => {\n            const issuer = learnCard.id.did();\n\n            const originalId: string | undefined = (original as any).id;\n            const subjectIds = getSubjectIds(original);\n            const targetId = originalId || subjectIds[0];\n            if (!targetId)\n                throw new Error('Original credential must have either id or credentialSubject.id');\n\n            const context: (string | Record<string, any>)[] = [\n                'https://www.w3.org/ns/credentials/v2',\n                ENDORSEMENT_CONTEXT,\n            ];\n\n            const types: [string, ...string[]] = ['VerifiableCredential', 'EndorsementCredential'];\n\n            const unsigned: UnsignedVC = {\n                '@context': context as any,\n                type: types,\n                issuer,\n                validFrom: new Date().toISOString(),\n                credentialSubject: {\n                    type: ['EndorsementSubject'],\n                    id: targetId,\n                    ...(details.endorsementComment\n                        ? { endorsementComment: details.endorsementComment }\n                        : {}),\n                },\n                ...(details.name ? { name: details.name } : { name: `Endorsement of ${targetId}` }),\n                ...(details.description ? { description: details.description } : {}),\n                ...(details.evidence && { evidence: details.evidence as any }),\n            };\n\n            return learnCard.invoke.issueCredential(unsigned);\n        },\n\n        verifyEndorsement: async (_learnCard, endorsement, options) => {\n            const check = await learnCard.invoke.verifyCredential(endorsement, options);\n\n            const ctx = ensureArray((endorsement as any)['@context']);\n            const types = ensureArray((endorsement as any)['type']);\n\n            if (\n                !ctx.some((c: string) => c === 'https://www.w3.org/ns/credentials/v2') ||\n                !ctx.some((c: string) => c === ENDORSEMENT_CONTEXT)\n            ) {\n                check.errors.push('linked-claims error: missing VCv2 or OBv3 context');\n            }\n            if (!types.includes('EndorsementCredential')) {\n                check.errors.push('linked-claims error: missing EndorsementCredential type');\n            }\n\n            const cs: any = (endorsement as any).credentialSubject;\n            const csObj = Array.isArray(cs) ? cs[0] : cs;\n            const csTypes = ensureArray<string>(csObj?.type);\n            if (!csTypes.includes('EndorsementSubject')) {\n                check.errors.push(\n                    'linked-claims error: credentialSubject.type must include EndorsementSubject'\n                );\n            }\n            if (!csObj?.id) {\n                check.errors.push('linked-claims error: credentialSubject.id missing');\n            }\n\n            if (!check.errors.length) check.checks.push('linked-claims');\n            return check;\n        },\n\n        storeEndorsement: async (_learnCard, endorsement, options) => {\n            const storeName = pickStoreProvider(learnCard, options?.storeName);\n            if (!storeName) throw new Error('No store plane provider available');\n            if (\n                !learnCard.store[storeName].uploadEncrypted ||\n                typeof learnCard.store[storeName].uploadEncrypted !== 'function'\n            ) {\n                throw new Error(\n                    `Store provider '${storeName}' does not support uploadEncrypted method`\n                );\n            }\n            const uri: string = await (learnCard.store as any)[storeName].uploadEncrypted(\n                endorsement\n            );\n\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            let indexed = false;\n            let id =\n                (endorsement as any).id ||\n                `urn:uuid:${(globalThis as any).crypto?.randomUUID?.() ||\n                (() => {\n                    throw new Error(\n                        'Secure random UUID generation is not available. Please use an environment that supports crypto.randomUUID().'\n                    );\n                })()\n                }`;\n\n            if (indexName) {\n                const cs: any = (endorsement as any).credentialSubject;\n                const csObj = Array.isArray(cs) ? cs[0] : cs;\n                const record = {\n                    id,\n                    uri,\n                    type: ensureArray((endorsement as any).type),\n                    endorsedId: csObj?.id,\n                    subjectId: csObj?.id,\n                    originalCredentialId: csObj?.id,\n                    issuedOn: (endorsement as any).validFrom || (endorsement as any).issuanceDate,\n                    category: 'Endorsement',\n                    credentialId: options?.credentialId, // original credential id\n                    sharedUri: options?.sharedUri, // original credential shared uri\n                    relationship: options?.relationship,\n                    visibility: options?.visibility ?? 'public',\n                };\n                indexed = await (learnCard.index as any)[indexName].add(record);\n            }\n\n            return { uri, indexed, id, indexName, storeName };\n        },\n\n        getEndorsements: async (_learnCard, original, options) => {\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            if (!indexName) return [];\n\n            const subjectIds = getSubjectIds(original);\n            const originalId = (original as any).id;\n\n            const query = originalId\n                ? { originalCredentialId: originalId }\n                : { endorsedId: subjectIds[0] };\n            const records = await (learnCard.index as any)[indexName].get(query);\n\n            const results: VC[] = [];\n            for (const rec of records) {\n                const vc = await learnCard.read.get(rec.uri);\n                if (vc) results.push(vc as VC);\n            }\n            return results;\n        },\n    },\n});\n"],
-  "mappings": "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",
-  "names": ["index_exports", "__export", "getLinkedClaimsPlugin", "__toCommonJS", "ENDORSEMENT_CONTEXT", "getSubjectIds", "__name", "credential", "subject", "s", "pickIndexProvider", "learnCard", "preferred", "providers", "k", "pickStoreProvider", "ensureArray", "arr", "getLinkedClaimsPlugin", "_learnCard", "original", "details", "opts", "issuer", "originalId", "subjectIds", "targetId", "unsigned", "endorsement", "options", "check", "ctx", "types", "c", "cs", "csObj", "storeName", "uri", "indexName", "indexed", "id", "record", "query", "records", "results", "rec", "vc"]
+  "sourcesContent": ["import type { LearnCard } from '@learncard/core';\nimport type { VC, UnsignedVC } from '@learncard/types';\nimport type { LinkedClaimsPlugin, LinkedClaimsPluginDependentMethods } from './types';\n\nexport * from './types';\n\nconst ENDORSEMENT_CONTEXT = 'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json';\n\nconst pickIndexProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.index || {}).filter(\n        k => !['providers', 'all'].includes(k)\n    );\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    if (providers.includes('LearnCloud')) return 'LearnCloud';\n    return providers[0];\n};\n\nconst pickStoreProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.store || {}).filter(k => k !== 'providers');\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    return providers[0];\n};\n\nconst ensureArray = <T>(arr: T | T[] | undefined): T[] =>\n    Array.isArray(arr) ? arr : arr ? [arr] : [];\n\nexport const getLinkedClaimsPlugin = (\n    learnCard: LearnCard<any, 'id' | 'store' | 'index' | 'read', LinkedClaimsPluginDependentMethods>\n): LinkedClaimsPlugin => ({\n    name: 'LinkedClaims',\n    displayName: 'LinkedClaims',\n    description: 'Create, verify, store, and retrieve endorsement credentials linked to originals.',\n    methods: {\n        endorseCredential: async (_learnCard, original, details, opts) => {\n            const issuer = learnCard.id.did();\n\n            const targetId = original.id;\n            if (!targetId) throw new Error('Original credential must have an id');\n\n            const context: (string | Record<string, any>)[] = [\n                'https://www.w3.org/ns/credentials/v2',\n                ENDORSEMENT_CONTEXT,\n            ];\n\n            const types: [string, ...string[]] = ['VerifiableCredential', 'EndorsementCredential'];\n\n            const unsigned: UnsignedVC = {\n                '@context': context as any,\n                type: types,\n                issuer,\n                validFrom: new Date().toISOString(),\n                credentialSubject: {\n                    type: ['EndorsementSubject'],\n                    id: targetId,\n                    ...(details.endorsementComment\n                        ? { endorsementComment: details.endorsementComment }\n                        : {}),\n                },\n                ...(details.name ? { name: details.name } : { name: `Endorsement of ${targetId}` }),\n                ...(details.description ? { description: details.description } : {}),\n                ...(details.evidence && { evidence: details.evidence as any }),\n            };\n\n            return learnCard.invoke.issueCredential(unsigned);\n        },\n\n        verifyEndorsement: async (_learnCard, endorsement, options) => {\n            const check = await learnCard.invoke.verifyCredential(endorsement, options);\n\n            const ctx = ensureArray((endorsement as any)['@context']);\n            const types = ensureArray((endorsement as any)['type']);\n\n            if (\n                !ctx.some((c: string) => c === 'https://www.w3.org/ns/credentials/v2') ||\n                !ctx.some((c: string) => c === ENDORSEMENT_CONTEXT)\n            ) {\n                check.errors.push('linked-claims error: missing VCv2 or OBv3 context');\n            }\n            if (!types.includes('EndorsementCredential')) {\n                check.errors.push('linked-claims error: missing EndorsementCredential type');\n            }\n\n            const cs: any = (endorsement as any).credentialSubject;\n            const csObj = Array.isArray(cs) ? cs[0] : cs;\n            const csTypes = ensureArray<string>(csObj?.type);\n            if (!csTypes.includes('EndorsementSubject')) {\n                check.errors.push(\n                    'linked-claims error: credentialSubject.type must include EndorsementSubject'\n                );\n            }\n            if (!csObj?.id) {\n                check.errors.push('linked-claims error: credentialSubject.id missing');\n            }\n\n            if (!check.errors.length) check.checks.push('linked-claims');\n            return check;\n        },\n\n        storeEndorsement: async (_learnCard, endorsement, options) => {\n            const storeName = pickStoreProvider(learnCard, options?.storeName);\n            if (!storeName) throw new Error('No store plane provider available');\n            if (\n                !learnCard.store[storeName].uploadEncrypted ||\n                typeof learnCard.store[storeName].uploadEncrypted !== 'function'\n            ) {\n                throw new Error(\n                    `Store provider '${storeName}' does not support uploadEncrypted method`\n                );\n            }\n            const uri: string = await (learnCard.store as any)[storeName].uploadEncrypted(\n                endorsement\n            );\n\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            let indexed = false;\n            // prettier-ignore\n            let id =\n                (endorsement as any).id ||\n                `urn:uuid:${globalThis.crypto?.randomUUID?.() ||\n                (() => {\n                    throw new Error(\n                        'Secure random UUID generation is not available. Please use an environment that supports crypto.randomUUID().'\n                    );\n                })()\n                }`;\n\n            if (indexName) {\n                const cs: any = (endorsement as any).credentialSubject;\n                const csObj = Array.isArray(cs) ? cs[0] : cs;\n                const record = {\n                    id,\n                    uri,\n                    type: ensureArray((endorsement as any).type),\n                    endorsedId: csObj?.id,\n                    subjectId: csObj?.id,\n                    originalCredentialId: csObj?.id,\n                    issuedOn: (endorsement as any).validFrom || (endorsement as any).issuanceDate,\n                    category: 'Endorsement',\n                    title: endorsement.name,\n                    credentialId: options?.credentialId ?? csObj?.id,\n                    sharedUri: options?.sharedUri, // original credential shared uri\n                    relationship: options?.relationship,\n                    visibility: options?.visibility ?? 'public',\n                };\n                indexed = await (learnCard.index as any)[indexName].add(record);\n            }\n\n            return { uri, indexed, id, indexName, storeName };\n        },\n\n        getEndorsements: async (_learnCard, original, options) => {\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            if (!indexName) return [];\n\n            if (!original.id) return [];\n\n            const query = { originalCredentialId: original.id };\n            const records = await (learnCard.index as any)[indexName].get(query);\n\n            const results: VC[] = [];\n            for (const rec of records) {\n                const vc = await learnCard.read.get(rec.uri);\n                if (vc) results.push(vc as VC);\n            }\n            return results;\n        },\n    },\n});\n"],
+  "mappings": "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",
+  "names": ["index_exports", "__export", "getLinkedClaimsPlugin", "__toCommonJS", "ENDORSEMENT_CONTEXT", "pickIndexProvider", "__name", "learnCard", "preferred", "providers", "k", "pickStoreProvider", "ensureArray", "arr", "getLinkedClaimsPlugin", "_learnCard", "original", "details", "opts", "issuer", "targetId", "unsigned", "endorsement", "options", "check", "ctx", "types", "c", "cs", "csObj", "storeName", "uri", "indexName", "indexed", "id", "record", "query", "records", "results", "rec", "vc"]
 }

package/dist/linked-claims-plugin.esm.js

@@ -3,11 +3,6 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 
 // src/index.ts
 var ENDORSEMENT_CONTEXT = "https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json";
-var getSubjectIds = /* @__PURE__ */ __name((credential) => {
-  const subject = credential.credentialSubject;
-  if (Array.isArray(subject)) return subject.map((s) => s?.id).filter(Boolean);
-  return subject?.id ? [subject.id] : [];
-}, "getSubjectIds");
 var pickIndexProvider = /* @__PURE__ */ __name((learnCard, preferred) => {
   const providers = Object.keys(learnCard.index || {}).filter(
     (k) => !["providers", "all"].includes(k)
@@ -31,11 +26,8 @@ var getLinkedClaimsPlugin = /* @__PURE__ */ __name((learnCard) => ({
   methods: {
     endorseCredential: /* @__PURE__ */ __name(async (_learnCard, original, details, opts) => {
       const issuer = learnCard.id.did();
-      const originalId = original.id;
-      const subjectIds = getSubjectIds(original);
-      const targetId = originalId || subjectIds[0];
-      if (!targetId)
-        throw new Error("Original credential must have either id or credentialSubject.id");
+      const targetId = original.id;
+      if (!targetId) throw new Error("Original credential must have an id");
       const context = [
         "https://www.w3.org/ns/credentials/v2",
         ENDORSEMENT_CONTEXT
@@ -111,8 +103,8 @@ var getLinkedClaimsPlugin = /* @__PURE__ */ __name((learnCard) => ({
           originalCredentialId: csObj?.id,
           issuedOn: endorsement.validFrom || endorsement.issuanceDate,
           category: "Endorsement",
-          credentialId: options?.credentialId,
-          // original credential id
+          title: endorsement.name,
+          credentialId: options?.credentialId ?? csObj?.id,
           sharedUri: options?.sharedUri,
           // original credential shared uri
           relationship: options?.relationship,
@@ -125,9 +117,8 @@ var getLinkedClaimsPlugin = /* @__PURE__ */ __name((learnCard) => ({
     getEndorsements: /* @__PURE__ */ __name(async (_learnCard, original, options) => {
       const indexName = pickIndexProvider(learnCard, options?.indexName);
       if (!indexName) return [];
-      const subjectIds = getSubjectIds(original);
-      const originalId = original.id;
-      const query = originalId ? { originalCredentialId: originalId } : { endorsedId: subjectIds[0] };
+      if (!original.id) return [];
+      const query = { originalCredentialId: original.id };
       const records = await learnCard.index[indexName].get(query);
       const results = [];
       for (const rec of records) {

package/dist/linked-claims-plugin.esm.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["import type { LearnCard } from '@learncard/core';\nimport type { VC, UnsignedVC } from '@learncard/types';\nimport type { LinkedClaimsPlugin, LinkedClaimsPluginDependentMethods } from './types';\n\nexport * from './types';\n\nconst ENDORSEMENT_CONTEXT = 'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json';\n\nconst getSubjectIds = (credential: VC): string[] => {\n    const subject = credential.credentialSubject as any;\n    if (Array.isArray(subject)) return subject.map(s => s?.id).filter(Boolean);\n    return subject?.id ? [subject.id] : [];\n};\n\nconst pickIndexProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.index || {}).filter(\n        k => !['providers', 'all'].includes(k)\n    );\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    if (providers.includes('LearnCloud')) return 'LearnCloud';\n    return providers[0];\n};\n\nconst pickStoreProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.store || {}).filter(k => k !== 'providers');\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    return providers[0];\n};\n\nconst ensureArray = <T>(arr: T | T[] | undefined): T[] =>\n    Array.isArray(arr) ? arr : arr ? [arr] : [];\n\nexport const getLinkedClaimsPlugin = (\n    learnCard: LearnCard<any, 'id' | 'store' | 'index' | 'read', LinkedClaimsPluginDependentMethods>\n): LinkedClaimsPlugin => ({\n    name: 'LinkedClaims',\n    displayName: 'LinkedClaims',\n    description: 'Create, verify, store, and retrieve endorsement credentials linked to originals.',\n    methods: {\n        endorseCredential: async (_learnCard, original, details, opts) => {\n            const issuer = learnCard.id.did();\n\n            const originalId: string | undefined = (original as any).id;\n            const subjectIds = getSubjectIds(original);\n            const targetId = originalId || subjectIds[0];\n            if (!targetId)\n                throw new Error('Original credential must have either id or credentialSubject.id');\n\n            const context: (string | Record<string, any>)[] = [\n                'https://www.w3.org/ns/credentials/v2',\n                ENDORSEMENT_CONTEXT,\n            ];\n\n            const types: [string, ...string[]] = ['VerifiableCredential', 'EndorsementCredential'];\n\n            const unsigned: UnsignedVC = {\n                '@context': context as any,\n                type: types,\n                issuer,\n                validFrom: new Date().toISOString(),\n                credentialSubject: {\n                    type: ['EndorsementSubject'],\n                    id: targetId,\n                    ...(details.endorsementComment\n                        ? { endorsementComment: details.endorsementComment }\n                        : {}),\n                },\n                ...(details.name ? { name: details.name } : { name: `Endorsement of ${targetId}` }),\n                ...(details.description ? { description: details.description } : {}),\n                ...(details.evidence && { evidence: details.evidence as any }),\n            };\n\n            return learnCard.invoke.issueCredential(unsigned);\n        },\n\n        verifyEndorsement: async (_learnCard, endorsement, options) => {\n            const check = await learnCard.invoke.verifyCredential(endorsement, options);\n\n            const ctx = ensureArray((endorsement as any)['@context']);\n            const types = ensureArray((endorsement as any)['type']);\n\n            if (\n                !ctx.some((c: string) => c === 'https://www.w3.org/ns/credentials/v2') ||\n                !ctx.some((c: string) => c === ENDORSEMENT_CONTEXT)\n            ) {\n                check.errors.push('linked-claims error: missing VCv2 or OBv3 context');\n            }\n            if (!types.includes('EndorsementCredential')) {\n                check.errors.push('linked-claims error: missing EndorsementCredential type');\n            }\n\n            const cs: any = (endorsement as any).credentialSubject;\n            const csObj = Array.isArray(cs) ? cs[0] : cs;\n            const csTypes = ensureArray<string>(csObj?.type);\n            if (!csTypes.includes('EndorsementSubject')) {\n                check.errors.push(\n                    'linked-claims error: credentialSubject.type must include EndorsementSubject'\n                );\n            }\n            if (!csObj?.id) {\n                check.errors.push('linked-claims error: credentialSubject.id missing');\n            }\n\n            if (!check.errors.length) check.checks.push('linked-claims');\n            return check;\n        },\n\n        storeEndorsement: async (_learnCard, endorsement, options) => {\n            const storeName = pickStoreProvider(learnCard, options?.storeName);\n            if (!storeName) throw new Error('No store plane provider available');\n            if (\n                !learnCard.store[storeName].uploadEncrypted ||\n                typeof learnCard.store[storeName].uploadEncrypted !== 'function'\n            ) {\n                throw new Error(\n                    `Store provider '${storeName}' does not support uploadEncrypted method`\n                );\n            }\n            const uri: string = await (learnCard.store as any)[storeName].uploadEncrypted(\n                endorsement\n            );\n\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            let indexed = false;\n            let id =\n                (endorsement as any).id ||\n                `urn:uuid:${(globalThis as any).crypto?.randomUUID?.() ||\n                (() => {\n                    throw new Error(\n                        'Secure random UUID generation is not available. Please use an environment that supports crypto.randomUUID().'\n                    );\n                })()\n                }`;\n\n            if (indexName) {\n                const cs: any = (endorsement as any).credentialSubject;\n                const csObj = Array.isArray(cs) ? cs[0] : cs;\n                const record = {\n                    id,\n                    uri,\n                    type: ensureArray((endorsement as any).type),\n                    endorsedId: csObj?.id,\n                    subjectId: csObj?.id,\n                    originalCredentialId: csObj?.id,\n                    issuedOn: (endorsement as any).validFrom || (endorsement as any).issuanceDate,\n                    category: 'Endorsement',\n                    credentialId: options?.credentialId, // original credential id\n                    sharedUri: options?.sharedUri, // original credential shared uri\n                    relationship: options?.relationship,\n                    visibility: options?.visibility ?? 'public',\n                };\n                indexed = await (learnCard.index as any)[indexName].add(record);\n            }\n\n            return { uri, indexed, id, indexName, storeName };\n        },\n\n        getEndorsements: async (_learnCard, original, options) => {\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            if (!indexName) return [];\n\n            const subjectIds = getSubjectIds(original);\n            const originalId = (original as any).id;\n\n            const query = originalId\n                ? { originalCredentialId: originalId }\n                : { endorsedId: subjectIds[0] };\n            const records = await (learnCard.index as any)[indexName].get(query);\n\n            const results: VC[] = [];\n            for (const rec of records) {\n                const vc = await learnCard.read.get(rec.uri);\n                if (vc) results.push(vc as VC);\n            }\n            return results;\n        },\n    },\n});\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { LearnCard } from '@learncard/core';\nimport type { VC, UnsignedVC } from '@learncard/types';\nimport type { LinkedClaimsPlugin, LinkedClaimsPluginDependentMethods } from './types';\n\nexport * from './types';\n\nconst ENDORSEMENT_CONTEXT = 'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json';\n\nconst pickIndexProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.index || {}).filter(\n        k => !['providers', 'all'].includes(k)\n    );\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    if (providers.includes('LearnCloud')) return 'LearnCloud';\n    return providers[0];\n};\n\nconst pickStoreProvider = (learnCard: any, preferred?: string): string | undefined => {\n    const providers = Object.keys(learnCard.store || {}).filter(k => k !== 'providers');\n    if (!providers.length) return undefined;\n    if (preferred && providers.includes(preferred)) return preferred;\n    return providers[0];\n};\n\nconst ensureArray = <T>(arr: T | T[] | undefined): T[] =>\n    Array.isArray(arr) ? arr : arr ? [arr] : [];\n\nexport const getLinkedClaimsPlugin = (\n    learnCard: LearnCard<any, 'id' | 'store' | 'index' | 'read', LinkedClaimsPluginDependentMethods>\n): LinkedClaimsPlugin => ({\n    name: 'LinkedClaims',\n    displayName: 'LinkedClaims',\n    description: 'Create, verify, store, and retrieve endorsement credentials linked to originals.',\n    methods: {\n        endorseCredential: async (_learnCard, original, details, opts) => {\n            const issuer = learnCard.id.did();\n\n            const targetId = original.id;\n            if (!targetId) throw new Error('Original credential must have an id');\n\n            const context: (string | Record<string, any>)[] = [\n                'https://www.w3.org/ns/credentials/v2',\n                ENDORSEMENT_CONTEXT,\n            ];\n\n            const types: [string, ...string[]] = ['VerifiableCredential', 'EndorsementCredential'];\n\n            const unsigned: UnsignedVC = {\n                '@context': context as any,\n                type: types,\n                issuer,\n                validFrom: new Date().toISOString(),\n                credentialSubject: {\n                    type: ['EndorsementSubject'],\n                    id: targetId,\n                    ...(details.endorsementComment\n                        ? { endorsementComment: details.endorsementComment }\n                        : {}),\n                },\n                ...(details.name ? { name: details.name } : { name: `Endorsement of ${targetId}` }),\n                ...(details.description ? { description: details.description } : {}),\n                ...(details.evidence && { evidence: details.evidence as any }),\n            };\n\n            return learnCard.invoke.issueCredential(unsigned);\n        },\n\n        verifyEndorsement: async (_learnCard, endorsement, options) => {\n            const check = await learnCard.invoke.verifyCredential(endorsement, options);\n\n            const ctx = ensureArray((endorsement as any)['@context']);\n            const types = ensureArray((endorsement as any)['type']);\n\n            if (\n                !ctx.some((c: string) => c === 'https://www.w3.org/ns/credentials/v2') ||\n                !ctx.some((c: string) => c === ENDORSEMENT_CONTEXT)\n            ) {\n                check.errors.push('linked-claims error: missing VCv2 or OBv3 context');\n            }\n            if (!types.includes('EndorsementCredential')) {\n                check.errors.push('linked-claims error: missing EndorsementCredential type');\n            }\n\n            const cs: any = (endorsement as any).credentialSubject;\n            const csObj = Array.isArray(cs) ? cs[0] : cs;\n            const csTypes = ensureArray<string>(csObj?.type);\n            if (!csTypes.includes('EndorsementSubject')) {\n                check.errors.push(\n                    'linked-claims error: credentialSubject.type must include EndorsementSubject'\n                );\n            }\n            if (!csObj?.id) {\n                check.errors.push('linked-claims error: credentialSubject.id missing');\n            }\n\n            if (!check.errors.length) check.checks.push('linked-claims');\n            return check;\n        },\n\n        storeEndorsement: async (_learnCard, endorsement, options) => {\n            const storeName = pickStoreProvider(learnCard, options?.storeName);\n            if (!storeName) throw new Error('No store plane provider available');\n            if (\n                !learnCard.store[storeName].uploadEncrypted ||\n                typeof learnCard.store[storeName].uploadEncrypted !== 'function'\n            ) {\n                throw new Error(\n                    `Store provider '${storeName}' does not support uploadEncrypted method`\n                );\n            }\n            const uri: string = await (learnCard.store as any)[storeName].uploadEncrypted(\n                endorsement\n            );\n\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            let indexed = false;\n            // prettier-ignore\n            let id =\n                (endorsement as any).id ||\n                `urn:uuid:${globalThis.crypto?.randomUUID?.() ||\n                (() => {\n                    throw new Error(\n                        'Secure random UUID generation is not available. Please use an environment that supports crypto.randomUUID().'\n                    );\n                })()\n                }`;\n\n            if (indexName) {\n                const cs: any = (endorsement as any).credentialSubject;\n                const csObj = Array.isArray(cs) ? cs[0] : cs;\n                const record = {\n                    id,\n                    uri,\n                    type: ensureArray((endorsement as any).type),\n                    endorsedId: csObj?.id,\n                    subjectId: csObj?.id,\n                    originalCredentialId: csObj?.id,\n                    issuedOn: (endorsement as any).validFrom || (endorsement as any).issuanceDate,\n                    category: 'Endorsement',\n                    title: endorsement.name,\n                    credentialId: options?.credentialId ?? csObj?.id,\n                    sharedUri: options?.sharedUri, // original credential shared uri\n                    relationship: options?.relationship,\n                    visibility: options?.visibility ?? 'public',\n                };\n                indexed = await (learnCard.index as any)[indexName].add(record);\n            }\n\n            return { uri, indexed, id, indexName, storeName };\n        },\n\n        getEndorsements: async (_learnCard, original, options) => {\n            const indexName = pickIndexProvider(learnCard, options?.indexName);\n            if (!indexName) return [];\n\n            if (!original.id) return [];\n\n            const query = { originalCredentialId: original.id };\n            const records = await (learnCard.index as any)[indexName].get(query);\n\n            const results: VC[] = [];\n            for (const rec of records) {\n                const vc = await learnCard.read.get(rec.uri);\n                if (vc) results.push(vc as VC);\n            }\n            return results;\n        },\n    },\n});\n"],
+  "mappings": ";;;;AAMA,IAAM,sBAAsB;AAE5B,IAAM,oBAAoB,wBAAC,WAAgB,cAA2C;AAClF,QAAM,YAAY,OAAO,KAAK,UAAU,SAAS,CAAC,CAAC,EAAE;AAAA,IACjD,OAAK,CAAC,CAAC,aAAa,KAAK,EAAE,SAAS,CAAC;AAAA,EACzC;AACA,MAAI,CAAC,UAAU,OAAQ,QAAO;AAC9B,MAAI,aAAa,UAAU,SAAS,SAAS,EAAG,QAAO;AACvD,MAAI,UAAU,SAAS,YAAY,EAAG,QAAO;AAC7C,SAAO,UAAU,CAAC;AACtB,GAR0B;AAU1B,IAAM,oBAAoB,wBAAC,WAAgB,cAA2C;AAClF,QAAM,YAAY,OAAO,KAAK,UAAU,SAAS,CAAC,CAAC,EAAE,OAAO,OAAK,MAAM,WAAW;AAClF,MAAI,CAAC,UAAU,OAAQ,QAAO;AAC9B,MAAI,aAAa,UAAU,SAAS,SAAS,EAAG,QAAO;AACvD,SAAO,UAAU,CAAC;AACtB,GAL0B;AAO1B,IAAM,cAAc,wBAAI,QACpB,MAAM,QAAQ,GAAG,IAAI,MAAM,MAAM,CAAC,GAAG,IAAI,CAAC,GAD1B;AAGb,IAAM,wBAAwB,wBACjC,eACsB;AAAA,EACtB,MAAM;AAAA,EACN,aAAa;AAAA,EACb,aAAa;AAAA,EACb,SAAS;AAAA,IACL,mBAAmB,8BAAO,YAAY,UAAU,SAAS,SAAS;AAC9D,YAAM,SAAS,UAAU,GAAG,IAAI;AAEhC,YAAM,WAAW,SAAS;AAC1B,UAAI,CAAC,SAAU,OAAM,IAAI,MAAM,qCAAqC;AAEpE,YAAM,UAA4C;AAAA,QAC9C;AAAA,QACA;AAAA,MACJ;AAEA,YAAM,QAA+B,CAAC,wBAAwB,uBAAuB;AAErF,YAAM,WAAuB;AAAA,QACzB,YAAY;AAAA,QACZ,MAAM;AAAA,QACN;AAAA,QACA,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,QAClC,mBAAmB;AAAA,UACf,MAAM,CAAC,oBAAoB;AAAA,UAC3B,IAAI;AAAA,UACJ,GAAI,QAAQ,qBACN,EAAE,oBAAoB,QAAQ,mBAAmB,IACjD,CAAC;AAAA,QACX;AAAA,QACA,GAAI,QAAQ,OAAO,EAAE,MAAM,QAAQ,KAAK,IAAI,EAAE,MAAM,kBAAkB,QAAQ,GAAG;AAAA,QACjF,GAAI,QAAQ,cAAc,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;AAAA,QAClE,GAAI,QAAQ,YAAY,EAAE,UAAU,QAAQ,SAAgB;AAAA,MAChE;AAEA,aAAO,UAAU,OAAO,gBAAgB,QAAQ;AAAA,IACpD,GA/BmB;AAAA,IAiCnB,mBAAmB,8BAAO,YAAY,aAAa,YAAY;AAC3D,YAAM,QAAQ,MAAM,UAAU,OAAO,iBAAiB,aAAa,OAAO;AAE1E,YAAM,MAAM,YAAa,YAAoB,UAAU,CAAC;AACxD,YAAM,QAAQ,YAAa,YAAoB,MAAM,CAAC;AAEtD,UACI,CAAC,IAAI,KAAK,CAAC,MAAc,MAAM,sCAAsC,KACrE,CAAC,IAAI,KAAK,CAAC,MAAc,MAAM,mBAAmB,GACpD;AACE,cAAM,OAAO,KAAK,mDAAmD;AAAA,MACzE;AACA,UAAI,CAAC,MAAM,SAAS,uBAAuB,GAAG;AAC1C,cAAM,OAAO,KAAK,yDAAyD;AAAA,MAC/E;AAEA,YAAM,KAAW,YAAoB;AACrC,YAAM,QAAQ,MAAM,QAAQ,EAAE,IAAI,GAAG,CAAC,IAAI;AAC1C,YAAM,UAAU,YAAoB,OAAO,IAAI;AAC/C,UAAI,CAAC,QAAQ,SAAS,oBAAoB,GAAG;AACzC,cAAM,OAAO;AAAA,UACT;AAAA,QACJ;AAAA,MACJ;AACA,UAAI,CAAC,OAAO,IAAI;AACZ,cAAM,OAAO,KAAK,mDAAmD;AAAA,MACzE;AAEA,UAAI,CAAC,MAAM,OAAO,OAAQ,OAAM,OAAO,KAAK,eAAe;AAC3D,aAAO;AAAA,IACX,GA9BmB;AAAA,IAgCnB,kBAAkB,8BAAO,YAAY,aAAa,YAAY;AAC1D,YAAM,YAAY,kBAAkB,WAAW,SAAS,SAAS;AACjE,UAAI,CAAC,UAAW,OAAM,IAAI,MAAM,mCAAmC;AACnE,UACI,CAAC,UAAU,MAAM,SAAS,EAAE,mBAC5B,OAAO,UAAU,MAAM,SAAS,EAAE,oBAAoB,YACxD;AACE,cAAM,IAAI;AAAA,UACN,mBAAmB,SAAS;AAAA,QAChC;AAAA,MACJ;AACA,YAAM,MAAc,MAAO,UAAU,MAAc,SAAS,EAAE;AAAA,QAC1D;AAAA,MACJ;AAEA,YAAM,YAAY,kBAAkB,WAAW,SAAS,SAAS;AACjE,UAAI,UAAU;AAEd,UAAI,KACC,YAAoB,MACrB,YAAY,WAAW,QAAQ,aAAa,MAC3C,MAAM;AACH,cAAM,IAAI;AAAA,UACN;AAAA,QACJ;AAAA,MACJ,GAAG,CACH;AAEJ,UAAI,WAAW;AACX,cAAM,KAAW,YAAoB;AACrC,cAAM,QAAQ,MAAM,QAAQ,EAAE,IAAI,GAAG,CAAC,IAAI;AAC1C,cAAM,SAAS;AAAA,UACX;AAAA,UACA;AAAA,UACA,MAAM,YAAa,YAAoB,IAAI;AAAA,UAC3C,YAAY,OAAO;AAAA,UACnB,WAAW,OAAO;AAAA,UAClB,sBAAsB,OAAO;AAAA,UAC7B,UAAW,YAAoB,aAAc,YAAoB;AAAA,UACjE,UAAU;AAAA,UACV,OAAO,YAAY;AAAA,UACnB,cAAc,SAAS,gBAAgB,OAAO;AAAA,UAC9C,WAAW,SAAS;AAAA;AAAA,UACpB,cAAc,SAAS;AAAA,UACvB,YAAY,SAAS,cAAc;AAAA,QACvC;AACA,kBAAU,MAAO,UAAU,MAAc,SAAS,EAAE,IAAI,MAAM;AAAA,MAClE;AAEA,aAAO,EAAE,KAAK,SAAS,IAAI,WAAW,UAAU;AAAA,IACpD,GAlDkB;AAAA,IAoDlB,iBAAiB,8BAAO,YAAY,UAAU,YAAY;AACtD,YAAM,YAAY,kBAAkB,WAAW,SAAS,SAAS;AACjE,UAAI,CAAC,UAAW,QAAO,CAAC;AAExB,UAAI,CAAC,SAAS,GAAI,QAAO,CAAC;AAE1B,YAAM,QAAQ,EAAE,sBAAsB,SAAS,GAAG;AAClD,YAAM,UAAU,MAAO,UAAU,MAAc,SAAS,EAAE,IAAI,KAAK;AAEnE,YAAM,UAAgB,CAAC;AACvB,iBAAW,OAAO,SAAS;AACvB,cAAM,KAAK,MAAM,UAAU,KAAK,IAAI,IAAI,GAAG;AAC3C,YAAI,GAAI,SAAQ,KAAK,EAAQ;AAAA,MACjC;AACA,aAAO;AAAA,IACX,GAfiB;AAAA,EAgBrB;AACJ,IA7IqC;",
   "names": []
 }

package/dist/test/store-endorsement.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store-endorsement.test.d.ts.map

package/dist/test/store-endorsement.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-endorsement.test.d.ts","sourceRoot":"","sources":["../../src/test/store-endorsement.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@learncard/linked-claims-plugin",
-    "version": "0.2.35",
+    "version": "0.2.36",
     "description": "LinkedClaims plugin to create, verify, store, and query endorsement credentials.",
     "type": "module",
     "main": "./dist/index.cjs",
@@ -47,9 +47,9 @@
     },
     "types": "./dist/index.d.ts",
     "dependencies": {
-        "@learncard/core": "9.4.35",
-        "@learncard/types": "5.20.0",
-        "@learncard/vc-plugin": "^1.6.1",
+        "@learncard/core": "9.4.36",
+        "@learncard/types": "5.21.0",
+        "@learncard/vc-plugin": "^1.6.2",
         "why-is-node-running": "^2.2.2"
     },
     "sideEffects": false

package/src/index.ts

@@ -6,12 +6,6 @@ export * from './types';
 
 const ENDORSEMENT_CONTEXT = 'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json';
 
-const getSubjectIds = (credential: VC): string[] => {
-    const subject = credential.credentialSubject as any;
-    if (Array.isArray(subject)) return subject.map(s => s?.id).filter(Boolean);
-    return subject?.id ? [subject.id] : [];
-};
-
 const pickIndexProvider = (learnCard: any, preferred?: string): string | undefined => {
     const providers = Object.keys(learnCard.index || {}).filter(
         k => !['providers', 'all'].includes(k)
@@ -42,11 +36,8 @@ export const getLinkedClaimsPlugin = (
         endorseCredential: async (_learnCard, original, details, opts) => {
             const issuer = learnCard.id.did();
 
-            const originalId: string | undefined = (original as any).id;
-            const subjectIds = getSubjectIds(original);
-            const targetId = originalId || subjectIds[0];
-            if (!targetId)
-                throw new Error('Original credential must have either id or credentialSubject.id');
+            const targetId = original.id;
+            if (!targetId) throw new Error('Original credential must have an id');
 
             const context: (string | Record<string, any>)[] = [
                 'https://www.w3.org/ns/credentials/v2',
@@ -124,9 +115,10 @@ export const getLinkedClaimsPlugin = (
 
             const indexName = pickIndexProvider(learnCard, options?.indexName);
             let indexed = false;
+            // prettier-ignore
             let id =
                 (endorsement as any).id ||
-                `urn:uuid:${(globalThis as any).crypto?.randomUUID?.() ||
+                `urn:uuid:${globalThis.crypto?.randomUUID?.() ||
                 (() => {
                     throw new Error(
                         'Secure random UUID generation is not available. Please use an environment that supports crypto.randomUUID().'
@@ -146,7 +138,8 @@ export const getLinkedClaimsPlugin = (
                     originalCredentialId: csObj?.id,
                     issuedOn: (endorsement as any).validFrom || (endorsement as any).issuanceDate,
                     category: 'Endorsement',
-                    credentialId: options?.credentialId, // original credential id
+                    title: endorsement.name,
+                    credentialId: options?.credentialId ?? csObj?.id,
                     sharedUri: options?.sharedUri, // original credential shared uri
                     relationship: options?.relationship,
                     visibility: options?.visibility ?? 'public',
@@ -161,12 +154,9 @@ export const getLinkedClaimsPlugin = (
             const indexName = pickIndexProvider(learnCard, options?.indexName);
             if (!indexName) return [];
 
-            const subjectIds = getSubjectIds(original);
-            const originalId = (original as any).id;
+            if (!original.id) return [];
 
-            const query = originalId
-                ? { originalCredentialId: originalId }
-                : { endorsedId: subjectIds[0] };
+            const query = { originalCredentialId: original.id };
             const records = await (learnCard.index as any)[indexName].get(query);
 
             const results: VC[] = [];

package/src/test/linked-claims.test.ts

@@ -1,205 +1,258 @@
+/* eslint-disable @typescript-eslint/no-explicit-any -- legacy plugin mocks intentionally model flexible LearnCard surfaces. */
 import { getLinkedClaimsPlugin } from '../index';
 import type { VC, VerificationCheck } from '@learncard/types';
 
 // Minimal mock LearnCard with just the surfaces the plugin uses
 const createMockLearnCard = () => {
-  const mock = {
-    id: { did: () => 'did:example:issuer' },
-    invoke: {
-      issueCredential: async (unsigned: any): Promise<VC> => ({
-        id: 'urn:uuid:endorsement-1',
-        ...unsigned,
-      }) as any,
-      verifyCredential: async (_vc: VC, _opts?: any): Promise<VerificationCheck> => ({
-        checks: [],
-        warnings: [],
-        errors: [],
-      }),
-    },
-    // Not used in these tests, but kept for completeness
-    store: { TestStore: { uploadEncrypted: async (_: any) => 'lc://test-uri' } },
-    index: {
-      LearnCloud: {
-        add: async (_: any) => true,
-        get: async (_: any) => [],
-      },
-    },
-    read: { get: async (_: string) => undefined },
-  } as unknown as any;
-
-  return mock;
+    const mock = {
+        id: { did: () => 'did:example:issuer' },
+        invoke: {
+            issueCredential: async (unsigned: any): Promise<VC> =>
+                ({
+                    id: 'urn:uuid:endorsement-1',
+                    ...unsigned,
+                }) as any,
+            verifyCredential: async (_vc: VC, _opts?: any): Promise<VerificationCheck> => ({
+                checks: [],
+                warnings: [],
+                errors: [],
+            }),
+        },
+        // Not used in these tests, but kept for completeness
+        store: { TestStore: { uploadEncrypted: async (_: any) => 'lc://test-uri' } },
+        index: {
+            LearnCloud: {
+                add: async (_: any) => true,
+                get: async (_: any) => [],
+            },
+        },
+        read: { get: async (_: string) => undefined },
+    } as unknown as any;
+
+    return mock;
 };
 
 const VC_V2 = 'https://www.w3.org/ns/credentials/v2';
 const OBV3 = 'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json';
 
-const makeOriginalWithId = (): VC => ({
-  '@context': [VC_V2],
-  type: ['VerifiableCredential'],
-  issuer: 'did:example:someone',
-  validFrom: new Date().toISOString(),
-  credentialSubject: { id: 'did:example:subject-123' },
-  id: 'urn:uuid:original-123',
-} as any);
-
-const makeOriginalWithoutIdButSubject = (): VC => ({
-  '@context': [VC_V2],
-  type: ['VerifiableCredential'],
-  issuer: 'did:example:someone',
-  validFrom: new Date().toISOString(),
-  credentialSubject: { id: 'did:example:subject-abc' },
-} as any);
+const makeOriginalWithId = (): VC =>
+    ({
+        '@context': [VC_V2],
+        type: ['VerifiableCredential'],
+        issuer: 'did:example:someone',
+        validFrom: new Date().toISOString(),
+        credentialSubject: { id: 'did:example:subject-123' },
+        id: 'urn:uuid:original-123',
+    }) as any;
+
+const makeOriginalWithoutIdButSubject = (): VC =>
+    ({
+        '@context': [VC_V2],
+        type: ['VerifiableCredential'],
+        issuer: 'did:example:someone',
+        validFrom: new Date().toISOString(),
+        credentialSubject: { id: 'did:example:subject-abc' },
+    }) as any;
 
 const clone = <T>(obj: T): T => JSON.parse(JSON.stringify(obj));
 
 describe('LinkedClaims Plugin', () => {
-  test('endorseCredential: minimal (comment only) with original id', async () => {
-    const lc = createMockLearnCard();
-    const plugin = getLinkedClaimsPlugin(lc);
-
-    const original = makeOriginalWithId();
-
-    const endorsement = await plugin.methods.endorseCredential(
-      lc,
-      original,
-      { endorsementComment: 'Solid work' },
-      {}
-    );
-
-    const ctx = endorsement['@context'] as any[];
-    expect(Array.isArray(ctx)).toBe(true);
-    expect(ctx).toEqual(expect.arrayContaining([VC_V2, OBV3]));
-
-    const types = endorsement.type as string[];
-    expect(types).toEqual(expect.arrayContaining(['VerifiableCredential', 'EndorsementCredential']));
-
-    expect((endorsement as any).issuer).toBe('did:example:issuer');
-
-    const cs = (endorsement as any).credentialSubject;
-    const csObj = Array.isArray(cs) ? cs[0] : cs;
-    expect(csObj.id).toBe('urn:uuid:original-123'); // prefers original.id when present
-    expect(csObj.type).toEqual(expect.arrayContaining(['EndorsementSubject']));
-    expect(csObj.endorsementComment).toBe('Solid work');
-
-    // default name applied when not provided
-    expect((endorsement as any).name).toBe('Endorsement of urn:uuid:original-123');
-  });
-
-  test('endorseCredential: with name and description only, resolves subject id fallback', async () => {
-    const lc = createMockLearnCard();
-    const plugin = getLinkedClaimsPlugin(lc);
-    const original = makeOriginalWithoutIdButSubject();
-
-    const endorsement = await plugin.methods.endorseCredential(
-      lc,
-      original,
-      { name: 'Kudos', description: 'Peer endorsement' },
-      {}
-    );
-
-    const cs = (endorsement as any).credentialSubject;
-    const csObj = Array.isArray(cs) ? cs[0] : cs;
-    expect(csObj.id).toBe('did:example:subject-abc');
-    expect((endorsement as any).name).toBe('Kudos');
-    expect((endorsement as any).description).toBe('Peer endorsement');
-    expect(csObj.endorsementComment).toBeUndefined();
-  });
-
-  test('endorseCredential: throws if original lacks id and credentialSubject.id', async () => {
-    const lc = createMockLearnCard();
-    const plugin = getLinkedClaimsPlugin(lc);
-
-    const original = {
-      '@context': [VC_V2],
-      type: ['VerifiableCredential'],
-      issuer: 'did:example:none',
-      validFrom: new Date().toISOString(),
-      credentialSubject: {},
-    } as any as VC;
-
-    await expect(
-      plugin.methods.endorseCredential(lc, original, { endorsementComment: 'x' }, {})
-    ).rejects.toThrow('Original credential must have either id or credentialSubject.id');
-  });
-
-  test('verifyEndorsement: valid endorsement passes and adds linked-claims check', async () => {
-    const lc = createMockLearnCard();
-    const plugin = getLinkedClaimsPlugin(lc);
-    const original = makeOriginalWithId();
-
-    const endorsement = await plugin.methods.endorseCredential(lc, original, { endorsementComment: 'Nice' }, {});
-
-    const result = await plugin.methods.verifyEndorsement(lc, endorsement, {});
-    expect(result.errors).toHaveLength(0);
-    expect(result.checks).toEqual(expect.arrayContaining(['linked-claims']));
-  });
-
-  test('verifyEndorsement: missing OBv3 context -> error', async () => {
-    const lc = createMockLearnCard();
-    const plugin = getLinkedClaimsPlugin(lc);
-    const original = makeOriginalWithId();
-
-    const endorsement = await plugin.methods.endorseCredential(lc, original, { endorsementComment: 'x' }, {});
-    const bad = clone(endorsement);
-    (bad as any)['@context'] = [VC_V2];
-
-    const res = await plugin.methods.verifyEndorsement(lc, bad as any, {});
-    expect(res.errors.join(' ')).toMatch(/missing VCv2 or OBv3 context/);
-  });
-
-  test('verifyEndorsement: missing VC v2 context -> error', async () => {
-    const lc = createMockLearnCard();
-    const plugin = getLinkedClaimsPlugin(lc);
-    const original = makeOriginalWithId();
-
-    const endorsement = await plugin.methods.endorseCredential(lc, original, { endorsementComment: 'x' }, {});
-    const bad = clone(endorsement);
-    (bad as any)['@context'] = [OBV3];
-
-    const res = await plugin.methods.verifyEndorsement(lc, bad as any, {});
-    expect(res.errors.join(' ')).toMatch(/missing VCv2 or OBv3 context/);
-  });
-
-  test('verifyEndorsement: missing EndorsementCredential type -> error', async () => {
-    const lc = createMockLearnCard();
-    const plugin = getLinkedClaimsPlugin(lc);
-    const original = makeOriginalWithId();
-
-    const endorsement = await plugin.methods.endorseCredential(lc, original, { endorsementComment: 'x' }, {});
-    const bad = clone(endorsement);
-    (bad as any).type = ['VerifiableCredential'];
-
-    const res = await plugin.methods.verifyEndorsement(lc, bad as any, {});
-    expect(res.errors.join(' ')).toMatch(/missing EndorsementCredential type/);
-  });
-
-  test('verifyEndorsement: subject type missing EndorsementSubject -> error', async () => {
-    const lc = createMockLearnCard();
-    const plugin = getLinkedClaimsPlugin(lc);
-    const original = makeOriginalWithId();
-
-    const endorsement = await plugin.methods.endorseCredential(lc, original, { endorsementComment: 'x' }, {});
-    const bad = clone(endorsement);
-    const cs = (bad as any).credentialSubject;
-    const csObj = Array.isArray(cs) ? cs[0] : cs;
-    csObj.type = ['SomeOtherType'];
-
-    const res = await plugin.methods.verifyEndorsement(lc, bad as any, {});
-    expect(res.errors.join(' ')).toMatch(/credentialSubject\.type must include EndorsementSubject/);
-  });
-
-  test('verifyEndorsement: missing credentialSubject.id -> error', async () => {
-    const lc = createMockLearnCard();
-    const plugin = getLinkedClaimsPlugin(lc);
-    const original = makeOriginalWithId();
-
-    const endorsement = await plugin.methods.endorseCredential(lc, original, { endorsementComment: 'x' }, {});
-    const bad = clone(endorsement);
-    const cs = (bad as any).credentialSubject;
-    const csObj = Array.isArray(cs) ? cs[0] : cs;
-    delete csObj.id;
-
-    const res = await plugin.methods.verifyEndorsement(lc, bad as any, {});
-    expect(res.errors.join(' ')).toMatch(/credentialSubject\.id missing/);
-  });
+    test('endorseCredential: minimal (comment only) with original id', async () => {
+        const lc = createMockLearnCard();
+        const plugin = getLinkedClaimsPlugin(lc);
+
+        const original = makeOriginalWithId();
+
+        const endorsement = await plugin.methods.endorseCredential(
+            lc,
+            original,
+            { endorsementComment: 'Solid work' },
+            {}
+        );
+
+        const ctx = endorsement['@context'] as any[];
+        expect(Array.isArray(ctx)).toBe(true);
+        expect(ctx).toEqual(expect.arrayContaining([VC_V2, OBV3]));
+
+        const types = endorsement.type as string[];
+        expect(types).toEqual(
+            expect.arrayContaining(['VerifiableCredential', 'EndorsementCredential'])
+        );
+
+        expect((endorsement as any).issuer).toBe('did:example:issuer');
+
+        const cs = (endorsement as any).credentialSubject;
+        const csObj = Array.isArray(cs) ? cs[0] : cs;
+        expect(csObj.id).toBe('urn:uuid:original-123'); // prefers original.id when present
+        expect(csObj.type).toEqual(expect.arrayContaining(['EndorsementSubject']));
+        expect(csObj.endorsementComment).toBe('Solid work');
+
+        // default name applied when not provided
+        expect((endorsement as any).name).toBe('Endorsement of urn:uuid:original-123');
+    });
+
+    test('uses the endorsing wallet DID instead of the target identity as issuer', async () => {
+        const lc = createMockLearnCard();
+        const plugin = getLinkedClaimsPlugin(lc);
+        const target = {
+            ...makeOriginalWithId(),
+            id: `urn:sha256:${'a'.repeat(64)}`,
+            issuer: `urn:sha256:${'b'.repeat(64)}`,
+        };
+
+        const endorsement = await plugin.methods.endorseCredential(
+            lc,
+            target,
+            { endorsementComment: 'Solid work' },
+            {}
+        );
+
+        expect(endorsement.issuer).toBe('did:example:issuer');
+        expect((endorsement.credentialSubject as { id?: string }).id).toBe(target.id);
+    });
+
+    test('endorseCredential: rejects a subject DID as a credential target', async () => {
+        const lc = createMockLearnCard();
+        const plugin = getLinkedClaimsPlugin(lc);
+        const original = makeOriginalWithoutIdButSubject();
+
+        await expect(
+            plugin.methods.endorseCredential(
+                lc,
+                original,
+                { name: 'Kudos', description: 'Peer endorsement' },
+                {}
+            )
+        ).rejects.toThrow('Original credential must have an id');
+    });
+
+    test('endorseCredential: throws if original lacks id and credentialSubject.id', async () => {
+        const lc = createMockLearnCard();
+        const plugin = getLinkedClaimsPlugin(lc);
+
+        const original = {
+            '@context': [VC_V2],
+            type: ['VerifiableCredential'],
+            issuer: 'did:example:none',
+            validFrom: new Date().toISOString(),
+            credentialSubject: {},
+        } as any as VC;
+
+        await expect(
+            plugin.methods.endorseCredential(lc, original, { endorsementComment: 'x' }, {})
+        ).rejects.toThrow('Original credential must have an id');
+    });
+
+    test('verifyEndorsement: valid endorsement passes and adds linked-claims check', async () => {
+        const lc = createMockLearnCard();
+        const plugin = getLinkedClaimsPlugin(lc);
+        const original = makeOriginalWithId();
+
+        const endorsement = await plugin.methods.endorseCredential(
+            lc,
+            original,
+            { endorsementComment: 'Nice' },
+            {}
+        );
+
+        const result = await plugin.methods.verifyEndorsement(lc, endorsement, {});
+        expect(result.errors).toHaveLength(0);
+        expect(result.checks).toEqual(expect.arrayContaining(['linked-claims']));
+    });
+
+    test('verifyEndorsement: missing OBv3 context -> error', async () => {
+        const lc = createMockLearnCard();
+        const plugin = getLinkedClaimsPlugin(lc);
+        const original = makeOriginalWithId();
+
+        const endorsement = await plugin.methods.endorseCredential(
+            lc,
+            original,
+            { endorsementComment: 'x' },
+            {}
+        );
+        const bad = clone(endorsement);
+        (bad as any)['@context'] = [VC_V2];
+
+        const res = await plugin.methods.verifyEndorsement(lc, bad as any, {});
+        expect(res.errors.join(' ')).toMatch(/missing VCv2 or OBv3 context/);
+    });
+
+    test('verifyEndorsement: missing VC v2 context -> error', async () => {
+        const lc = createMockLearnCard();
+        const plugin = getLinkedClaimsPlugin(lc);
+        const original = makeOriginalWithId();
+
+        const endorsement = await plugin.methods.endorseCredential(
+            lc,
+            original,
+            { endorsementComment: 'x' },
+            {}
+        );
+        const bad = clone(endorsement);
+        (bad as any)['@context'] = [OBV3];
+
+        const res = await plugin.methods.verifyEndorsement(lc, bad as any, {});
+        expect(res.errors.join(' ')).toMatch(/missing VCv2 or OBv3 context/);
+    });
+
+    test('verifyEndorsement: missing EndorsementCredential type -> error', async () => {
+        const lc = createMockLearnCard();
+        const plugin = getLinkedClaimsPlugin(lc);
+        const original = makeOriginalWithId();
+
+        const endorsement = await plugin.methods.endorseCredential(
+            lc,
+            original,
+            { endorsementComment: 'x' },
+            {}
+        );
+        const bad = clone(endorsement);
+        (bad as any).type = ['VerifiableCredential'];
+
+        const res = await plugin.methods.verifyEndorsement(lc, bad as any, {});
+        expect(res.errors.join(' ')).toMatch(/missing EndorsementCredential type/);
+    });
+
+    test('verifyEndorsement: subject type missing EndorsementSubject -> error', async () => {
+        const lc = createMockLearnCard();
+        const plugin = getLinkedClaimsPlugin(lc);
+        const original = makeOriginalWithId();
+
+        const endorsement = await plugin.methods.endorseCredential(
+            lc,
+            original,
+            { endorsementComment: 'x' },
+            {}
+        );
+        const bad = clone(endorsement);
+        const cs = (bad as any).credentialSubject;
+        const csObj = Array.isArray(cs) ? cs[0] : cs;
+        csObj.type = ['SomeOtherType'];
+
+        const res = await plugin.methods.verifyEndorsement(lc, bad as any, {});
+        expect(res.errors.join(' ')).toMatch(
+            /credentialSubject\.type must include EndorsementSubject/
+        );
+    });
+
+    test('verifyEndorsement: missing credentialSubject.id -> error', async () => {
+        const lc = createMockLearnCard();
+        const plugin = getLinkedClaimsPlugin(lc);
+        const original = makeOriginalWithId();
+
+        const endorsement = await plugin.methods.endorseCredential(
+            lc,
+            original,
+            { endorsementComment: 'x' },
+            {}
+        );
+        const bad = clone(endorsement);
+        const cs = (bad as any).credentialSubject;
+        const csObj = Array.isArray(cs) ? cs[0] : cs;
+        delete csObj.id;
+
+        const res = await plugin.methods.verifyEndorsement(lc, bad as any, {});
+        expect(res.errors.join(' ')).toMatch(/credentialSubject\.id missing/);
+    });
 });

package/src/test/store-endorsement.test.ts

@@ -0,0 +1,65 @@
+import { describe, expect, it, vi } from 'vitest';
+import type { VC } from '@learncard/types';
+
+import { getLinkedClaimsPlugin } from '../index';
+import type { LinkedClaimsPlugin } from '../types';
+
+type LinkedClaimsLearnCard = Parameters<LinkedClaimsPlugin['methods']['storeEndorsement']>[0];
+
+const endorsement = {
+    '@context': ['https://www.w3.org/2018/credentials/v1'],
+    type: ['VerifiableCredential', 'EndorsementCredential'],
+    issuer: 'did:example:endorser',
+    name: 'Endorsement of First Aid',
+    credentialSubject: {
+        id: 'urn:uuid:original-123',
+        type: ['EndorsementSubject'],
+    },
+} as unknown as VC;
+
+const createTestContext = () => {
+    const add = vi.fn().mockResolvedValue(true);
+    const learnCard = {
+        store: {
+            LearnCloud: {
+                uploadEncrypted: vi.fn().mockResolvedValue('lc:endorsement:1'),
+            },
+        },
+        index: { LearnCloud: { add } },
+    } as unknown as LinkedClaimsLearnCard;
+
+    return { add, learnCard };
+};
+
+describe('storeEndorsement', () => {
+    it('indexes the signed target when metadata omits credentialId', async () => {
+        const { add, learnCard } = createTestContext();
+        const plugin = getLinkedClaimsPlugin(learnCard);
+
+        await plugin.methods.storeEndorsement(learnCard, endorsement, {});
+
+        expect(add).toHaveBeenCalledWith(
+            expect.objectContaining({
+                credentialId: 'urn:uuid:original-123',
+                originalCredentialId: 'urn:uuid:original-123',
+                title: 'Endorsement of First Aid',
+            })
+        );
+    });
+
+    it('preserves an explicit wrapper credential id', async () => {
+        const { add, learnCard } = createTestContext();
+        const plugin = getLinkedClaimsPlugin(learnCard);
+
+        await plugin.methods.storeEndorsement(learnCard, endorsement, {
+            credentialId: 'urn:uuid:wrapper-credential',
+        });
+
+        expect(add).toHaveBeenCalledWith(
+            expect.objectContaining({
+                credentialId: 'urn:uuid:wrapper-credential',
+                originalCredentialId: 'urn:uuid:original-123',
+            })
+        );
+    });
+});