@cooperation/vc-storage 1.0.46 → 1.0.49

package/dist/models/CredentialEngine.js

@@ -5,15 +5,11 @@ import { v4 as uuidv4 } from 'uuid';
 import { extractKeyPairFromCredential, generateDIDSchema, generateUnsignedEmployment, generateUnsignedPerformanceReview, generateUnsignedRecommendation, generateUnsignedSkillClaim, generateUnsignedVC, generateUnsignedVolunteering, } from '../utils/credential.js';
 import { securityLoader } from '@digitalcredentials/security-document-loader';
 import hrContext from 'hr-context';
-// Add hr-context for SkillClaimCredential; patch socCode (@type→@container)
-const hrCtxData = JSON.parse(JSON.stringify(hrContext.CONTEXT_V1));
-if (hrCtxData?.['@context']?.socCode) {
-    delete hrCtxData['@context'].socCode['@type'];
-    hrCtxData['@context'].socCode['@container'] = '@set';
-}
+// Add hr-context for SkillClaimCredential (defines socCode, inferredSkill,
+// model, source, frameworkMatch as of hr-context@0.2.0).
 const loader = securityLoader();
-loader.addStatic(hrContext.CONTEXT_URL_V1, hrCtxData);
-loader.addStatic('https://w3id.org/hr/v1', hrCtxData);
+loader.addStatic(hrContext.CONTEXT_URL_V1, hrContext.CONTEXT_V1);
+loader.addStatic('https://w3id.org/hr/v1', hrContext.CONTEXT_V1);
 const builtLoader = loader.build();
 /** Document loader compatible with @digitalcredentials/vc */
 export const documentLoader = async (url) => {

package/dist/types/models/CredentialEngine.d.ts

@@ -5,8 +5,7 @@ export declare const documentLoader: (url: string) => Promise<{
     document: any;
 }>;
 import type { IVerifiableCredential } from '@digitalcredentials/ssi';
-import { DidDocument, KeyPair, FormDataI, RecommendationFormDataI, EmploymentFormDataI, PerformanceReviewFormDataI, VolunteeringFormDataI } from '../../types';
-import type { ISkillClaimCredential } from 'hr-context';
+import { DidDocument, KeyPair, FormDataI, RecommendationFormDataI, EmploymentFormDataI, PerformanceReviewFormDataI, VolunteeringFormDataI, SkillClaimFormDataI } from '../../types';
 import { GoogleDriveStorage } from './GoogleDriveStorage.js';
 interface SignPropsI {
     data: FormDataI | RecommendationFormDataI | EmploymentFormDataI | VolunteeringFormDataI | PerformanceReviewFormDataI;
@@ -82,7 +81,7 @@ export declare class CredentialEngine {
      * @param {string} issuerId - The issuer DID.
      * @returns {Promise<any>} The signed SkillClaimCredential.
      */
-    signSkillClaimVC(data: ISkillClaimCredential, keyPair: KeyPair, issuerId: string): Promise<any>;
+    signSkillClaimVC(data: SkillClaimFormDataI, keyPair: KeyPair, issuerId: string): Promise<any>;
     /**
      * Verify a Verifiable Credential (VC)
      * @param {object} credential - The Verifiable Credential to verify.

package/dist/types/utils/credential.d.ts

@@ -1,5 +1,4 @@
-import { KeyPair, DidDocument, FormDataI, RecommendationFormDataI, EvidenceItem, EmploymentFormDataI, VolunteeringFormDataI, PerformanceReviewFormDataI } from '../../types';
-import type { ISkillClaimCredential } from 'hr-context';
+import { KeyPair, DidDocument, FormDataI, RecommendationFormDataI, EvidenceItem, EmploymentFormDataI, VolunteeringFormDataI, PerformanceReviewFormDataI, SkillClaimFormDataI } from '../../types';
 import { IVerifiableCredential } from '@digitalcredentials/ssi';
 /**
  * Create a DID document using the provided key pair.
@@ -59,12 +58,15 @@ export declare function generateUnsignedPerformanceReview({ formData, issuerDid
  * - Uses `https://www.w3.org/ns/credentials/v2` and `https://w3id.org/hr/v1` contexts
  * - VC subtype is `SkillClaimCredential` (not `OpenBadgeCredential`)
  * - `credentialSubject.type` is `SkillClaim` with a `person` object and `skill` array
+ * - User-entered skills go in `credentialSubject.skill`; LLM-extracted skills go in
+ *   `credentialSubject.inferredSkill` with `source`/`model` provenance and
+ *   `frameworkMatch` alignments
  * - Evidence lives at the credential root (not inside `credentialSubject`)
  * - No `issuanceDate`/`expirationDate` set by the author
  * - Issuer is a plain DID string (no `type` wrapper)
  */
 export declare function generateUnsignedSkillClaim({ formData, issuerDid, }: {
-    formData: ISkillClaimCredential;
+    formData: SkillClaimFormDataI;
     issuerDid: string;
 }): IVerifiableCredential;
 /**

package/dist/utils/credential.js

@@ -264,6 +264,9 @@ export function generateUnsignedPerformanceReview({ formData, issuerDid }) {
  * - Uses `https://www.w3.org/ns/credentials/v2` and `https://w3id.org/hr/v1` contexts
  * - VC subtype is `SkillClaimCredential` (not `OpenBadgeCredential`)
  * - `credentialSubject.type` is `SkillClaim` with a `person` object and `skill` array
+ * - User-entered skills go in `credentialSubject.skill`; LLM-extracted skills go in
+ *   `credentialSubject.inferredSkill` with `source`/`model` provenance and
+ *   `frameworkMatch` alignments
  * - Evidence lives at the credential root (not inside `credentialSubject`)
  * - No `issuanceDate`/`expirationDate` set by the author
  * - Issuer is a plain DID string (no `type` wrapper)
@@ -290,11 +293,20 @@ export function generateUnsignedSkillClaim({ formData, issuerDid, }) {
                 name: s.name,
                 description: s.description,
                 durationPerformed: s.durationPerformed,
-                narrative: s.narrative,
                 image: s.image,
                 source: s.source,
-                frameworkMatch: s.frameworkMatch,
             })),
+            ...(formData.inferredSkills?.length
+                ? {
+                    inferredSkill: formData.inferredSkills.map((s) => ({
+                        id: `urn:uuid:${uuidv4()}`,
+                        name: s.name,
+                        source: s.source,
+                        model: s.model,
+                        frameworkMatch: s.frameworkMatch,
+                    })),
+                }
+                : {}),
         },
         evidence: formData.evidence?.length ? formData.evidence.map((e) => ({
             id: e.id,

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@cooperation/vc-storage",
 	"type": "module",
-	"version": "1.0.46",
+	"version": "1.0.49",
 	"description": "Sign and store your verifiable credentials.",
 	"main": "dist/index.js",
 	"types": "dist/types/index.d.ts",
@@ -32,7 +32,7 @@
 		"crypto-js": "^4.2.0",
 		"crypto-ld": "^7.0.0",
 		"ethers": "^6.13.2",
-		"hr-context": "^0.1.6",
+		"hr-context": "^0.2.0",
 		"jest": "^29.7.0",
 		"multiformats": "^13.3.6",
 		"ts-jest": "^29.2.5",

package/dist/types/utils/Ed25519Signer.d.ts

@@ -1,25 +0,0 @@
-/**
- * Ed25519 signer compatible with @wallet.storage/fetch-client.
- * Uses @digitalcredentials packages instead of @digitalbazaar.
- */
-import { Ed25519VerificationKey2020 } from '@digitalcredentials/ed25519-verification-key-2020';
-export declare class Ed25519Signer {
-    private readonly keyPair;
-    private readonly verificationMethod;
-    readonly algorithm = "Ed25519";
-    constructor(keyPair: Ed25519VerificationKey2020, verificationMethod: {
-        id: string;
-        type: string;
-        controller: string;
-        publicKeyMultibase: string;
-    });
-    static generate(): Promise<Ed25519Signer>;
-    static fromJSON(json: string): Promise<Ed25519Signer>;
-    get controller(): string;
-    get id(): string;
-    get publicKeyMultibase(): string;
-    sign({ data }: {
-        data: Uint8Array;
-    }): Promise<Uint8Array>;
-    toJSON(): object;
-}

package/dist/types/utils/customDocumentLoader.d.ts

@@ -1,6 +0,0 @@
-/** Document loader compatible with @digitalcredentials/vc */
-export declare const customDocumentLoader: (url: string) => Promise<{
-    contextUrl: string;
-    documentUrl: string;
-    document: any;
-}>;

package/dist/types/utils/digitalbazaar.d.ts

@@ -1 +0,0 @@
-export declare const customDocumentLoader: (url: string) => Promise<any>;

package/dist/utils/Ed25519Signer.js

@@ -1,71 +0,0 @@
-/**
- * Ed25519 signer compatible with @wallet.storage/fetch-client.
- * Uses @digitalcredentials packages instead of @digitalbazaar.
- */
-import { Ed25519VerificationKey2020 } from '@digitalcredentials/ed25519-verification-key-2020';
-export class Ed25519Signer {
-    keyPair;
-    verificationMethod;
-    algorithm = 'Ed25519';
-    constructor(keyPair, verificationMethod) {
-        this.keyPair = keyPair;
-        this.verificationMethod = verificationMethod;
-    }
-    static async generate() {
-        const keyPair = await Ed25519VerificationKey2020.generate();
-        const fingerprint = keyPair.fingerprint();
-        const controller = `did:key:${fingerprint}`;
-        keyPair.controller = controller;
-        keyPair.id = `${controller}#${fingerprint}`;
-        const verificationMethod = {
-            id: keyPair.id,
-            type: 'Ed25519VerificationKey2020',
-            controller,
-            publicKeyMultibase: keyPair.publicKeyMultibase,
-        };
-        return new Ed25519Signer(keyPair, verificationMethod);
-    }
-    static async fromJSON(json) {
-        const object = JSON.parse(json);
-        const { publicKeyMultibase, privateKeyMultibase, controller } = object;
-        if (typeof controller !== 'string') {
-            throw new Error('json object must have controller string', { cause: { parsedJson: object } });
-        }
-        if (typeof publicKeyMultibase !== 'string') {
-            throw new Error('json object must have publicKeyMultibase string', { cause: object });
-        }
-        if (typeof privateKeyMultibase !== 'string') {
-            throw new Error('json object must have privateKeyMultibase string', { cause: object });
-        }
-        const keyPair = await Ed25519VerificationKey2020.from({
-            type: 'Ed25519VerificationKey2020',
-            controller,
-            publicKeyMultibase,
-            privateKeyMultibase,
-        });
-        const fingerprint = keyPair.fingerprint();
-        const verificationMethod = {
-            id: `${controller}#${fingerprint}`,
-            type: 'Ed25519VerificationKey2020',
-            controller,
-            publicKeyMultibase: keyPair.publicKeyMultibase,
-        };
-        return new Ed25519Signer(keyPair, verificationMethod);
-    }
-    get controller() {
-        return this.keyPair.controller;
-    }
-    get id() {
-        return this.verificationMethod.id;
-    }
-    get publicKeyMultibase() {
-        return this.keyPair.publicKeyMultibase;
-    }
-    async sign({ data }) {
-        const signature = await this.keyPair.signer().sign({ data });
-        return signature;
-    }
-    toJSON() {
-        return this.keyPair.export({ publicKey: true, privateKey: true });
-    }
-}

package/dist/utils/customDocumentLoader.js

@@ -1,20 +0,0 @@
-/**
- * Document loader using @digitalcredentials/security-document-loader.
- * Adds hr-context for SkillClaimCredential support.
- * @see https://github.com/digitalcredentials/security-document-loader
- */
-import { securityLoader } from '@digitalcredentials/security-document-loader';
-import hrContext from 'hr-context';
-const loader = securityLoader();
-loader.addStatic(hrContext.CONTEXT_URL_V1, hrContext.CONTEXT_V1);
-loader.addStatic('https://w3id.org/hr/v1', hrContext.CONTEXT_V1);
-const builtLoader = loader.build();
-/** Document loader compatible with @digitalcredentials/vc */
-export const customDocumentLoader = async (url) => {
-    const result = await builtLoader(url);
-    return {
-        contextUrl: result.contextUrl ?? null,
-        documentUrl: result.documentUrl ?? url,
-        document: result.document,
-    };
-};

package/dist/utils/digitalbazaar.js

@@ -1,51 +0,0 @@
-import { Ed25519VerificationKey2020 } from '@digitalbazaar/ed25519-verification-key-2020';
-import { suiteContext as ed25519Context } from '@digitalbazaar/ed25519-signature-2020';
-import { driver as didKeyDriver } from '@digitalbazaar/did-method-key';
-import { defaultDocumentLoader } from '@digitalcredentials/vc';
-import { contexts as obContexts } from '@digitalcredentials/open-badges-context';
-import { contexts as credV1Contexts } from 'credentials-context';
-import { contexts as credV2Contexts } from '@digitalcredentials/credentials-v2-context';
-import hrContext from 'hr-context';
-// Initialize the DID method key driver
-const didKeyDriverInstance = didKeyDriver();
-didKeyDriverInstance.use({
-    multibaseMultikeyHeader: 'z6Mk',
-    fromMultibase: Ed25519VerificationKey2020.from,
-});
-// Patch the upstream hr-context socCode bug: "@type":"@set" -> "@container":"@set"
-const hrCtxData = structuredClone(hrContext.CONTEXT_V1);
-if (hrCtxData?.['@context']?.socCode) {
-    delete hrCtxData['@context'].socCode['@type'];
-    hrCtxData['@context'].socCode['@container'] = '@set';
-}
-// Build context map from installed packages
-const contextMap = new Map([
-    ...credV1Contexts,
-    ...credV2Contexts,
-    ...obContexts,
-    ...ed25519Context.contexts,
-    [hrContext.CONTEXT_URL_V1, hrCtxData],
-    ['https://w3id.org/hr/v1', hrCtxData],
-]);
-// Custom document loader
-export const customDocumentLoader = async (url) => {
-    const context = contextMap.get(url);
-    if (context) {
-        return {
-            contextUrl: null,
-            documentUrl: url,
-            document: context,
-        };
-    }
-    // Handle did:key resolution
-    if (url.startsWith('did:key:')) {
-        const didDocument = await didKeyDriverInstance.get({ did: url });
-        return {
-            contextUrl: null,
-            documentUrl: url,
-            document: didDocument,
-        };
-    }
-    // Fallback to the default document loader
-    return defaultDocumentLoader(url);
-};