@learncard/credential-library 2.0.2 → 2.0.4

package/README.md

@@ -251,7 +251,7 @@ See the [Credential Viewer README](../../examples/credential-viewer/README.md) f
 -   `vc-v2/membership-credential` — Professional association membership
 -   `vc-v2/license-credential` — Professional nursing license
 
-### Open Badges v3 (11)
+### Open Badges v3 (12)
 
 -   `obv3/minimal-badge` — Minimal OBv3 achievement credential
 -   `obv3/full-badge` — Full-featured badge with image, evidence, alignment, results, expiration
@@ -264,6 +264,7 @@ See the [Credential Viewer README](../../examples/credential-viewer/README.md) f
 -   `obv3/course-completion` — Introduction to Machine Learning course completion
 -   `obv3/k12-diploma` — High school diploma
 -   `obv3/endorsement-credential` — Program accreditation endorsement
+-   `obv3/rubric-aligned-badge` — Open Skills Alignment result with rubric levels and CTDL alignment
 
 ### CLR v2 (4)
 

package/dist/credential-library.cjs.development.js

@@ -68,6 +68,7 @@ __export(index_exports, {
   obv3OneedtechFull: () => obv3OneedtechFull,
   obv3PlugfestJff2: () => obv3PlugfestJff2,
   obv3ProfessionalCert: () => obv3ProfessionalCert,
+  obv3RubricAlignedBadge: () => obv3RubricAlignedBadge,
   obv3StandaloneFullCourse: () => obv3StandaloneFullCourse,
   obv3WithAlignment: () => obv3WithAlignment,
   obv3WithEndorsement: () => obv3WithEndorsement,
@@ -1585,8 +1586,107 @@ var obv3EndorsementCredential = {
   }
 };
 
-// src/fixtures/clr/minimal.ts
+// src/fixtures/obv3/rubric-aligned-badge.ts
 var import_types13 = require("@learncard/types");
+var RESULT_DESCRIPTION_ID = "urn:uuid:7cc1519e-87f4-4cae-b7a5-786ec15db769";
+var PROFICIENT_LEVEL_ID = "urn:uuid:eb753d86-9277-478d-b9c4-3d589c82aff8";
+var obv3RubricAlignedBadge = {
+  id: "obv3/rubric-aligned-badge",
+  name: "Rubric-Aligned OBv3 Badge",
+  description: "Open Badges v3 credential with rubric levels, an achieved level, and a CTDL result alignment",
+  spec: "obv3",
+  profile: "badge",
+  features: ["alignment", "results"],
+  source: "synthetic",
+  signed: false,
+  validity: "valid",
+  validator: import_types13.UnsignedAchievementCredentialValidator,
+  tags: ["rubric", "open-skill-alignment"],
+  credential: {
+    "@context": [
+      "https://www.w3.org/ns/credentials/v2",
+      "https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json"
+    ],
+    id: "urn:uuid:b3e5babd-f68e-4095-979d-3e910a444e73",
+    type: ["VerifiableCredential", "OpenBadgeCredential"],
+    name: "Applied Data Analysis",
+    description: "Recognizes applied data analysis at the proficient rubric level.",
+    issuer: {
+      id: "did:example:issuer123",
+      type: ["Profile"],
+      name: "Example Skills Institute",
+      url: "https://example.org"
+    },
+    validFrom: "2026-01-15T00:00:00Z",
+    credentialSubject: {
+      id: "did:example:learner456",
+      type: ["AchievementSubject"],
+      achievement: {
+        id: "urn:uuid:e736a10c-aa36-466f-99af-e52440f32d8e",
+        type: ["Achievement"],
+        achievementType: "Badge",
+        name: "Applied Data Analysis",
+        description: "Analyze a real-world dataset and communicate supported conclusions.",
+        criteria: {
+          narrative: "Submit an analysis that meets at least the proficient rubric level."
+        },
+        resultDescription: [
+          {
+            id: RESULT_DESCRIPTION_ID,
+            type: ["ResultDescription"],
+            name: "Data Analysis Rubric",
+            resultType: "RubricCriterionLevel",
+            valueMin: "1",
+            valueMax: "4",
+            rubricCriterionLevel: [
+              {
+                id: "urn:uuid:a4993932-d453-4417-b5aa-52b1bc1ea80e",
+                type: ["RubricCriterionLevel"],
+                name: "Developing",
+                level: "2",
+                points: "2"
+              },
+              {
+                id: PROFICIENT_LEVEL_ID,
+                type: ["RubricCriterionLevel"],
+                name: "Proficient",
+                level: "3",
+                points: "3"
+              },
+              {
+                id: "urn:uuid:217fc04f-383b-48a0-a2e5-1cf1b016f7d4",
+                type: ["RubricCriterionLevel"],
+                name: "Advanced",
+                level: "4",
+                points: "4"
+              }
+            ],
+            alignment: [
+              {
+                type: ["Alignment"],
+                targetName: "Analyze data using appropriate methods",
+                targetUrl: "https://credentialengineregistry.org/resources/ce-2f5dce8d-29ad-40cb-a9e1-5a5517ff79a7",
+                targetType: "CTDL",
+                targetFramework: "Credential Engine Registry"
+              }
+            ]
+          }
+        ]
+      },
+      result: [
+        {
+          type: ["Result"],
+          resultDescription: RESULT_DESCRIPTION_ID,
+          value: "3",
+          achievedLevel: PROFICIENT_LEVEL_ID
+        }
+      ]
+    }
+  }
+};
+
+// src/fixtures/clr/minimal.ts
+var import_types14 = require("@learncard/types");
 var clrMinimal = {
   id: "clr/minimal",
   name: "Minimal CLR v2 Credential",
@@ -1597,7 +1697,7 @@ var clrMinimal = {
   source: "spec-example",
   signed: false,
   validity: "valid",
-  validator: import_types13.UnsignedClrCredentialValidator,
+  validator: import_types14.UnsignedClrCredentialValidator,
   credential: {
     "@context": [
       "https://www.w3.org/ns/credentials/v2",
@@ -1636,7 +1736,7 @@ var clrMinimal = {
 };
 
 // src/fixtures/clr/multi-achievement.ts
-var import_types14 = require("@learncard/types");
+var import_types15 = require("@learncard/types");
 var clrMultiAchievement = {
   id: "clr/multi-achievement",
   name: "CLR v2 with Multiple Achievements and Associations",
@@ -1647,7 +1747,7 @@ var clrMultiAchievement = {
   source: "synthetic",
   signed: false,
   validity: "valid",
-  validator: import_types14.UnsignedClrCredentialValidator,
+  validator: import_types15.UnsignedClrCredentialValidator,
   tags: ["comprehensive"],
   credential: {
     "@context": [
@@ -2082,7 +2182,7 @@ var clrUniversityTranscript = {
 };
 
 // src/fixtures/boost/basic.ts
-var import_types15 = require("@learncard/types");
+var import_types16 = require("@learncard/types");
 var boostBasic = {
   id: "boost/basic",
   name: "Basic LearnCard Boost",
@@ -2093,7 +2193,7 @@ var boostBasic = {
   source: "synthetic",
   signed: false,
   validity: "valid",
-  validator: import_types15.UnsignedAchievementCredentialValidator,
+  validator: import_types16.UnsignedAchievementCredentialValidator,
   tags: ["learncard", "boost"],
   credential: {
     "@context": [
@@ -2129,7 +2229,7 @@ var boostBasic = {
 };
 
 // src/fixtures/boost/boost-id.ts
-var import_types16 = require("@learncard/types");
+var import_types17 = require("@learncard/types");
 var boostId = {
   id: "boost/boost-id",
   name: "LearnCard Boost ID",
@@ -2140,7 +2240,7 @@ var boostId = {
   source: "synthetic",
   signed: false,
   validity: "valid",
-  validator: import_types16.UnsignedAchievementCredentialValidator,
+  validator: import_types17.UnsignedAchievementCredentialValidator,
   tags: ["learncard", "boost", "id"],
   credential: {
     "@context": [
@@ -2185,7 +2285,7 @@ var boostId = {
 };
 
 // src/fixtures/boost/with-skills.ts
-var import_types17 = require("@learncard/types");
+var import_types18 = require("@learncard/types");
 var boostWithSkills = {
   id: "boost/with-skills",
   name: "LearnCard Boost with Skills",
@@ -2196,7 +2296,7 @@ var boostWithSkills = {
   source: "synthetic",
   signed: false,
   validity: "valid",
-  validator: import_types17.UnsignedAchievementCredentialValidator,
+  validator: import_types18.UnsignedAchievementCredentialValidator,
   tags: ["learncard", "boost", "skills"],
   credential: {
     "@context": [
@@ -2406,7 +2506,7 @@ var boostDelegate = {
 };
 
 // src/fixtures/invalid/missing-context.ts
-var import_types18 = require("@learncard/types");
+var import_types19 = require("@learncard/types");
 var invalidMissingContext = {
   id: "invalid/missing-context",
   name: "Missing @context",
@@ -2417,7 +2517,7 @@ var invalidMissingContext = {
   source: "synthetic",
   signed: false,
   validity: "invalid",
-  validator: import_types18.UnsignedVCValidator,
+  validator: import_types19.UnsignedVCValidator,
   tags: ["negative-test"],
   credential: {
     // Intentionally missing '@context'
@@ -2430,7 +2530,7 @@ var invalidMissingContext = {
 };
 
 // src/fixtures/invalid/empty-type.ts
-var import_types19 = require("@learncard/types");
+var import_types20 = require("@learncard/types");
 var invalidEmptyType = {
   id: "invalid/empty-type",
   name: "Empty type Array",
@@ -2441,7 +2541,7 @@ var invalidEmptyType = {
   source: "synthetic",
   signed: false,
   validity: "invalid",
-  validator: import_types19.UnsignedVCValidator,
+  validator: import_types20.UnsignedVCValidator,
   tags: ["negative-test"],
   credential: {
     "@context": ["https://www.w3.org/ns/credentials/v2"],
@@ -2454,7 +2554,7 @@ var invalidEmptyType = {
 };
 
 // src/fixtures/invalid/missing-issuer.ts
-var import_types20 = require("@learncard/types");
+var import_types21 = require("@learncard/types");
 var invalidMissingIssuer = {
   id: "invalid/missing-issuer",
   name: "Missing Issuer",
@@ -2465,7 +2565,7 @@ var invalidMissingIssuer = {
   source: "synthetic",
   signed: false,
   validity: "invalid",
-  validator: import_types20.UnsignedVCValidator,
+  validator: import_types21.UnsignedVCValidator,
   tags: ["negative-test"],
   credential: {
     "@context": ["https://www.w3.org/ns/credentials/v2"],
@@ -14330,8 +14430,9 @@ var clrCompetencyAligned = {
 };
 
 // src/fixtures/clr/provisional-transcript.ts
-var import_types21 = require("@learncard/types");
+var import_types22 = require("@learncard/types");
 var REFRESH_SERVICE_INLINE_CONTEXT = {
+  partial: "https://purl.imsglobal.org/spec/clr/v2p0#partial",
   "LearnCardCredentialRefresh2026": "https://learncard.com/refresh#LearnCardCredentialRefresh2026",
   authorization: {
     "@id": "https://purl.imsglobal.org/spec/ob/v3p0#authorization",
@@ -14355,7 +14456,7 @@ var clrProvisionalTranscript = {
   source: "synthetic",
   signed: false,
   validity: "valid",
-  validator: import_types21.UnsignedClrCredentialValidator,
+  validator: import_types22.UnsignedClrCredentialValidator,
   tags: ["transcript", "provisional", "refresh", "clr", "managed-refresh"],
   credential: {
     "@context": [
@@ -14374,6 +14475,8 @@ var clrProvisionalTranscript = {
       name: "Ridgeview Community College \u2014 Office of the Registrar"
     },
     validFrom: "2026-01-15T00:00:00Z",
+    validUntil: "2026-05-31T00:00:00Z",
+    partial: true,
     refreshService: PLACEHOLDER_REFRESH_SERVICE,
     credentialSubject: {
       id: "did:example:student-ridgeview-042",
@@ -14394,7 +14497,8 @@ var clrProvisionalTranscript = {
               id: "urn:uuid:7d2e9f41-3c58-4e21-9b6a-1f0c5d8e2a49",
               type: ["ResultDescription"],
               name: "Course Status",
-              resultType: "RawScore"
+              resultType: "Status",
+              allowedValue: ["InProgress", "Provisional", "Completed"]
             }
           ]
         }
@@ -14448,6 +14552,8 @@ var buildFinalTranscriptVariant = /* @__PURE__ */ __name((provisional, options =
   final.name = "Final Official Transcript \u2014 Ridgeview Community College";
   final.description = "Final official transcript certified by the registrar. Supersedes the provisional record.";
   if (options.validFrom) final.validFrom = options.validFrom;
+  delete final.validUntil;
+  delete final.partial;
   const subject = final.credentialSubject;
   if (isRecord(subject) && Array.isArray(subject.verifiableCredential)) {
     subject.verifiableCredential = subject.verifiableCredential.map((nested) => {
@@ -14460,7 +14566,7 @@ var buildFinalTranscriptVariant = /* @__PURE__ */ __name((provisional, options =
         next.credentialSubject = {
           ...next.credentialSubject,
           result: next.credentialSubject.result.map(
-            (result) => isRecord(result) ? { ...result, status: "Completed", value: "A" } : result
+            (result) => isRecord(result) ? { ...result, status: "Completed", value: "Completed" } : result
           )
         };
       }
@@ -23024,6 +23130,7 @@ var ALL_FIXTURES = [
   obv3StandaloneFullCourse,
   obv3K12Diploma,
   obv3EndorsementCredential,
+  obv3RubricAlignedBadge,
   // CLR v2
   clrMinimal,
   clrMultiAchievement,
@@ -23274,6 +23381,7 @@ var patchSubject = /* @__PURE__ */ __name((subject, subjectDid) => {
   }
   return subject;
 }, "patchSubject");
+var FIXTURE_VALIDITY_MS = 180 * 24 * 60 * 60 * 1e3;
 var prepareFixture = /* @__PURE__ */ __name((fixture, options) => {
   if (isSdJwtVcFixture(fixture)) {
     throw new Error(
@@ -23310,6 +23418,17 @@ var prepareFixture = /* @__PURE__ */ __name((fixture, options) => {
     } else {
       credential.validUntil = validUntil;
     }
+  } else {
+    const from = new Date(
+      credential.validFrom ?? credential.issuanceDate
+    ).getTime();
+    const baseline = Math.max(from, Date.now());
+    for (const field of ["validUntil", "expirationDate"]) {
+      const expiry = credential[field];
+      if (typeof expiry === "string" && new Date(expiry).getTime() <= baseline) {
+        credential[field] = new Date(baseline + FIXTURE_VALIDITY_MS).toISOString();
+      }
+    }
   }
   return credential;
 }, "prepareFixture");