@learncard/credential-library 2.0.1 → 2.0.2

package/dist/__tests__/docs-json.test.d.ts

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

package/dist/__tests__/docs-json.test.d.ts.map

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

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

@@ -28,17 +28,20 @@ __export(index_exports, {
   FIXTURE_KINDS: () => FIXTURE_KINDS,
   FIXTURE_SOURCES: () => FIXTURE_SOURCES,
   FIXTURE_VALIDITIES: () => FIXTURE_VALIDITIES,
+  REFRESH_SERVICE_INLINE_CONTEXT: () => REFRESH_SERVICE_INLINE_CONTEXT,
   boostBasic: () => boostBasic,
   boostCommunityAward: () => boostCommunityAward,
   boostDelegate: () => boostDelegate,
   boostId: () => boostId,
   boostWithSkills: () => boostWithSkills,
+  buildFinalTranscriptVariant: () => buildFinalTranscriptVariant,
   clrCompetencyAligned: () => clrCompetencyAligned,
   clrDemoIsdDiplomaAssessments: () => clrDemoIsdDiplomaAssessments,
   clrGreatPlainsFull: () => clrGreatPlainsFull,
   clrMinimal: () => clrMinimal,
   clrMultiAchievement: () => clrMultiAchievement,
   clrNdStudentTranscript: () => clrNdStudentTranscript,
+  clrProvisionalTranscript: () => clrProvisionalTranscript,
   clrUniversityTranscript: () => clrUniversityTranscript,
   clrWestbridgeFull: () => clrWestbridgeFull,
   findFixture: () => findFixture,
@@ -14326,6 +14329,147 @@ var clrCompetencyAligned = {
   }
 };
 
+// src/fixtures/clr/provisional-transcript.ts
+var import_types21 = require("@learncard/types");
+var REFRESH_SERVICE_INLINE_CONTEXT = {
+  "LearnCardCredentialRefresh2026": "https://learncard.com/refresh#LearnCardCredentialRefresh2026",
+  authorization: {
+    "@id": "https://purl.imsglobal.org/spec/ob/v3p0#authorization",
+    "@context": {
+      LearnCardDIDAuth: "https://docs.learncard.com/definitions#LearnCardDIDAuth"
+    }
+  }
+};
+var PLACEHOLDER_REFRESH_SERVICE = {
+  id: "https://refresh.example.com/refresh/placeholder",
+  type: "LearnCardCredentialRefresh2026",
+  authorization: { type: "LearnCardDIDAuth" }
+};
+var clrProvisionalTranscript = {
+  id: "clr/provisional-transcript",
+  name: "Provisional Transcript (Refreshable)",
+  description: "A CLR v2 provisional transcript carrying a LearnCardCredentialRefresh2026 service. Paired with buildFinalTranscriptVariant, it demonstrates the managed provisional-to-final credential refresh flow.",
+  spec: "clr-v2",
+  profile: "learner-record",
+  features: ["refresh-service", "results"],
+  source: "synthetic",
+  signed: false,
+  validity: "valid",
+  validator: import_types21.UnsignedClrCredentialValidator,
+  tags: ["transcript", "provisional", "refresh", "clr", "managed-refresh"],
+  credential: {
+    "@context": [
+      "https://www.w3.org/ns/credentials/v2",
+      "https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json",
+      "https://purl.imsglobal.org/spec/clr/v2p0/context.json",
+      REFRESH_SERVICE_INLINE_CONTEXT
+    ],
+    id: "urn:uuid:7d2e9f41-3c58-4e21-9b6a-1f0c5d8e2a47",
+    type: ["VerifiableCredential", "ClrCredential"],
+    name: "Provisional Transcript \u2014 Ridgeview Community College",
+    description: "Provisional record of courses completed to date. This transcript becomes final once the registrar certifies the completed term.",
+    issuer: {
+      id: "did:web:registrar.ridgeview-example.edu",
+      type: ["Profile"],
+      name: "Ridgeview Community College \u2014 Office of the Registrar"
+    },
+    validFrom: "2026-01-15T00:00:00Z",
+    refreshService: PLACEHOLDER_REFRESH_SERVICE,
+    credentialSubject: {
+      id: "did:example:student-ridgeview-042",
+      type: ["ClrSubject"],
+      achievement: [
+        {
+          id: "urn:uuid:7d2e9f41-3c58-4e21-9b6a-1f0c5d8e2a48",
+          type: ["Achievement"],
+          achievementType: "Course",
+          name: "BIO 150 \u2014 Principles of Biology",
+          description: "Introductory biology covering cell structure, genetics, and evolution.",
+          criteria: { narrative: "Complete all coursework and the final exam." },
+          humanCode: "BIO-150",
+          fieldOfStudy: "Biology",
+          creditsAvailable: 4,
+          resultDescription: [
+            {
+              id: "urn:uuid:7d2e9f41-3c58-4e21-9b6a-1f0c5d8e2a49",
+              type: ["ResultDescription"],
+              name: "Course Status",
+              resultType: "RawScore"
+            }
+          ]
+        }
+      ],
+      verifiableCredential: [
+        {
+          "@context": [
+            "https://www.w3.org/ns/credentials/v2",
+            "https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json"
+          ],
+          id: "urn:uuid:7d2e9f41-3c58-4e21-9b6a-1f0c5d8e2a50",
+          type: ["VerifiableCredential", "AchievementCredential"],
+          name: "BIO 150 \u2014 Principles of Biology (In Progress)",
+          issuer: {
+            id: "did:web:registrar.ridgeview-example.edu",
+            type: ["Profile"],
+            name: "Ridgeview Community College"
+          },
+          validFrom: "2026-01-15T00:00:00Z",
+          credentialSubject: {
+            id: "did:example:student-ridgeview-042",
+            type: ["AchievementSubject"],
+            achievement: {
+              id: "urn:uuid:7d2e9f41-3c58-4e21-9b6a-1f0c5d8e2a48",
+              type: ["Achievement"],
+              achievementType: "Course",
+              name: "BIO 150 \u2014 Principles of Biology",
+              criteria: {
+                narrative: "Complete all coursework and the final exam."
+              },
+              humanCode: "BIO-150",
+              fieldOfStudy: "Biology",
+              creditsAvailable: 4
+            },
+            result: [
+              {
+                type: ["Result"],
+                resultDescription: "urn:uuid:7d2e9f41-3c58-4e21-9b6a-1f0c5d8e2a49",
+                status: "InProgress"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  }
+};
+var buildFinalTranscriptVariant = /* @__PURE__ */ __name((provisional, options = {}) => {
+  const isRecord = /* @__PURE__ */ __name((value) => typeof value === "object" && value !== null, "isRecord");
+  const final = JSON.parse(JSON.stringify(provisional));
+  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;
+  const subject = final.credentialSubject;
+  if (isRecord(subject) && Array.isArray(subject.verifiableCredential)) {
+    subject.verifiableCredential = subject.verifiableCredential.map((nested) => {
+      if (!isRecord(nested)) return nested;
+      const next = { ...nested };
+      if (typeof next.name === "string") {
+        next.name = next.name.replace("(In Progress)", "(Completed)");
+      }
+      if (isRecord(next.credentialSubject) && Array.isArray(next.credentialSubject.result)) {
+        next.credentialSubject = {
+          ...next.credentialSubject,
+          result: next.credentialSubject.result.map(
+            (result) => isRecord(result) ? { ...result, status: "Completed", value: "A" } : result
+          )
+        };
+      }
+      return next;
+    });
+  }
+  return final;
+}, "buildFinalTranscriptVariant");
+
 // src/fixtures/clr/demo-isd-diploma-assessments.ts
 var clrDemoIsdDiplomaAssessments = {
   id: "clr/demo-isd-diploma-assessments",
@@ -22906,6 +23050,7 @@ var ALL_FIXTURES = [
   clrGreatPlainsFull,
   clrWestbridgeFull,
   clrCompetencyAligned,
+  clrProvisionalTranscript,
   clrDemoIsdDiplomaAssessments,
   // SD-JWT VC
   sdJwtVcCourseCompletion