@learncard/credential-library 2.0.5 → 2.1.1

package/src/fixtures/custom/course-enrollment.ts

@@ -0,0 +1,56 @@
+import { UnsignedVCValidator } from '@learncard/types';
+
+import type { CredentialFixture } from '../../types';
+
+// Example corpus provenance and alignment attribution: ../../../SOURCES.md.
+export const customCourseEnrollment: CredentialFixture = {
+    id: 'custom/course-enrollment',
+    name: 'Course Enrollment',
+    description:
+        'Administrative course enrollment claim without completion, assessment, or skill attainment.',
+    spec: 'custom',
+    profile: 'generic',
+    features: ['expiration'],
+    source: 'synthetic',
+    signed: false,
+    validity: 'valid',
+    validator: UnsignedVCValidator,
+    tags: ['enrollment', 'administrative', 'non-achievement'],
+
+    credential: {
+        '@context': [
+            'https://www.w3.org/ns/credentials/v2',
+            {
+                designation: 'https://fixtures.example.org/frenchfry/vocab/designation',
+                claimScope: 'https://fixtures.example.org/frenchfry/vocab/claimScope',
+                claimRole: 'https://fixtures.example.org/frenchfry/vocab/claimRole',
+                Profile: 'https://purl.imsglobal.org/spec/vc/ob/vocab.html#Profile',
+                url: {
+                    '@id': 'https://schema.org/url',
+                    '@type': 'https://www.w3.org/2001/XMLSchema#anyURI',
+                },
+                CourseEnrollmentCredential:
+                    'https://fixtures.example.org/frenchfry/vocab/CourseEnrollmentCredential',
+            },
+        ],
+        id: 'urn:uuid:6ea43ad2-3fb5-55dd-aee8-6380b7ec0725',
+        type: ['VerifiableCredential', 'CourseEnrollmentCredential'],
+        issuer: {
+            id: 'did:web:registrar.metropolis-university-example.edu',
+            type: ['Profile'],
+            name: 'Metropolis University – Office of the Registrar',
+            url: 'https://metropolis-university-example.edu',
+        },
+        validFrom: '2026-09-01T00:00:00Z',
+        validUntil: '2027-09-01T00:00:00Z',
+        name: 'Course Enrollment',
+        description:
+            'Administrative course enrollment claim without completion, assessment, or skill attainment.',
+        credentialSubject: {
+            id: 'https://fixtures.example.org/frenchfry/personas/admin-5',
+            designation: 'Course enrollment',
+            claimRole: 'student',
+            claimScope: 'Enrollment in a fictional database course',
+        },
+    },
+};

package/src/fixtures/custom/exam-accommodation.ts

@@ -0,0 +1,56 @@
+import { UnsignedVCValidator } from '@learncard/types';
+
+import type { CredentialFixture } from '../../types';
+
+// Example corpus provenance and alignment attribution: ../../../SOURCES.md.
+export const customExamAccommodation: CredentialFixture = {
+    id: 'custom/exam-accommodation',
+    name: 'Extended Exam Time',
+    description:
+        'Administrative exam accommodation claim without a diagnosis or assessed achievement.',
+    spec: 'custom',
+    profile: 'generic',
+    features: ['expiration'],
+    source: 'synthetic',
+    signed: false,
+    validity: 'valid',
+    validator: UnsignedVCValidator,
+    tags: ['accommodation', 'administrative', 'non-achievement'],
+
+    credential: {
+        '@context': [
+            'https://www.w3.org/ns/credentials/v2',
+            {
+                designation: 'https://fixtures.example.org/frenchfry/vocab/designation',
+                claimScope: 'https://fixtures.example.org/frenchfry/vocab/claimScope',
+                claimRole: 'https://fixtures.example.org/frenchfry/vocab/claimRole',
+                Profile: 'https://purl.imsglobal.org/spec/vc/ob/vocab.html#Profile',
+                url: {
+                    '@id': 'https://schema.org/url',
+                    '@type': 'https://www.w3.org/2001/XMLSchema#anyURI',
+                },
+                ExamAccommodationCredential:
+                    'https://fixtures.example.org/frenchfry/vocab/ExamAccommodationCredential',
+            },
+        ],
+        id: 'urn:uuid:0e341ee2-6006-51b9-a559-62d7ac21a4e1',
+        type: ['VerifiableCredential', 'ExamAccommodationCredential'],
+        issuer: {
+            id: 'did:web:university-example.edu',
+            type: ['Profile'],
+            name: 'State University',
+            url: 'https://university-example.edu',
+        },
+        validFrom: '2026-09-01T00:00:00Z',
+        validUntil: '2027-09-01T00:00:00Z',
+        name: 'Extended Exam Time',
+        description:
+            'Administrative exam accommodation claim without a diagnosis or assessed achievement.',
+        credentialSubject: {
+            id: 'https://fixtures.example.org/frenchfry/personas/admin-20',
+            designation: 'Extended exam time',
+            claimRole: 'recipient',
+            claimScope: 'Fictional extra time provision; no diagnosis included',
+        },
+    },
+};

package/src/fixtures/index.ts

@@ -31,6 +31,13 @@ import {
 } from './obv3/student-sample-badges';
 import { obv3StudentAdditionalCredentials } from './obv3/student-additional-credentials';
 import { obv3RubricAlignedBadge } from './obv3/rubric-aligned-badge';
+import { obv3QualificationLicense } from './obv3/qualification-license';
+import { obv3QualificationCertification } from './obv3/qualification-certification';
+import { obv3QualificationApprenticeship } from './obv3/qualification-apprenticeship';
+import { obv3QualificationJourneyman } from './obv3/qualification-journeyman';
+import { obv3QualificationMaster } from './obv3/qualification-master';
+import { obv3QualificationExpired } from './obv3/qualification-expired';
+import { obv3QualificationBadgeOverride } from './obv3/qualification-badge-override';
 
 // CLR v2
 import { clrMinimal } from './clr/minimal';
@@ -39,6 +46,7 @@ import { clrUniversityTranscript } from './clr/university-transcript';
 import { clrStudentOfficialAcademicTranscript } from './clr/student-official-academic-transcript';
 import { clrEmploymentRecord } from './clr/employment-record';
 import { clrTrainingProviderRecord } from './clr/training-provider-record';
+import { clrMilitaryComprehensiveRecord } from './clr/military-comprehensive-record';
 import { clrMilitaryTrainingRecord } from './clr/military-training-record';
 import { clrProfessionalOrganizationRecord } from './clr/professional-organization-record';
 import { clrLicensingRegulatoryRecord } from './clr/licensing-regulatory-record';
@@ -79,6 +87,15 @@ import {
 } from './clr/provisional-transcript';
 import { clrDemoIsdDiplomaAssessments } from './clr/demo-isd-diploma-assessments';
 
+// Curated practice, role, language, and administrative examples
+import { obv3FoodAllergenPractice } from './obv3/food-allergen-practice';
+import { obv3FoodAllergenFacilitator } from './obv3/food-allergen-facilitator';
+import { obv3FoodAllergenPracticeFr } from './obv3/food-allergen-practice-fr';
+import { obv3PhishingTransfer } from './obv3/phishing-transfer';
+import { customCourseEnrollment } from './custom/course-enrollment';
+import { customExamAccommodation } from './custom/exam-accommodation';
+import { clrMixedRolePortfolio } from './clr/mixed-role-portfolio';
+
 // SD-JWT VC
 import { sdJwtVcCourseCompletion } from './sd-jwt-vc/course-completion';
 
@@ -105,6 +122,13 @@ export const ALL_FIXTURES: LibraryFixture[] = [
     obv3PlugfestJff2,
     obv3OneedtechFull,
     obv3ProfessionalCert,
+    obv3QualificationLicense,
+    obv3QualificationCertification,
+    obv3QualificationApprenticeship,
+    obv3QualificationJourneyman,
+    obv3QualificationMaster,
+    obv3QualificationExpired,
+    obv3QualificationBadgeOverride,
     obv3MicroCredential,
     obv3CourseCompletion,
     obv3StandaloneFullCourse,
@@ -125,6 +149,7 @@ export const ALL_FIXTURES: LibraryFixture[] = [
     clrEmploymentRecord,
     clrTrainingProviderRecord,
     clrMilitaryTrainingRecord,
+    clrMilitaryComprehensiveRecord,
     clrProfessionalOrganizationRecord,
     clrLicensingRegulatoryRecord,
     clrMixedCareerRecord,
@@ -158,6 +183,15 @@ export const ALL_FIXTURES: LibraryFixture[] = [
     clrProvisionalTranscript,
     clrDemoIsdDiplomaAssessments,
 
+    // Curated examples
+    obv3FoodAllergenPractice,
+    obv3FoodAllergenFacilitator,
+    obv3FoodAllergenPracticeFr,
+    obv3PhishingTransfer,
+    customCourseEnrollment,
+    customExamAccommodation,
+    clrMixedRolePortfolio,
+
     // SD-JWT VC
     sdJwtVcCourseCompletion,
 ];
@@ -186,6 +220,13 @@ export {
     clrNdStudentTranscript,
     obv3OneedtechFull,
     obv3ProfessionalCert,
+    obv3QualificationLicense,
+    obv3QualificationCertification,
+    obv3QualificationApprenticeship,
+    obv3QualificationJourneyman,
+    obv3QualificationMaster,
+    obv3QualificationExpired,
+    obv3QualificationBadgeOverride,
     obv3MicroCredential,
     obv3CourseCompletion,
     obv3StandaloneFullCourse,
@@ -202,6 +243,7 @@ export {
     clrEmploymentRecord,
     clrTrainingProviderRecord,
     clrMilitaryTrainingRecord,
+    clrMilitaryComprehensiveRecord,
     clrProfessionalOrganizationRecord,
     clrLicensingRegulatoryRecord,
     clrMixedCareerRecord,
@@ -221,5 +263,12 @@ export {
     buildFinalTranscriptVariant,
     REFRESH_SERVICE_INLINE_CONTEXT,
     clrDemoIsdDiplomaAssessments,
+    obv3FoodAllergenPractice,
+    obv3FoodAllergenFacilitator,
+    obv3FoodAllergenPracticeFr,
+    obv3PhishingTransfer,
+    customCourseEnrollment,
+    customExamAccommodation,
+    clrMixedRolePortfolio,
     sdJwtVcCourseCompletion,
 };

package/src/fixtures/obv3/food-allergen-facilitator.ts

@@ -0,0 +1,108 @@
+import { UnsignedAchievementCredentialValidator } from '@learncard/types';
+
+import type { CredentialFixture } from '../../types';
+
+// Example corpus provenance and alignment attribution: ../../../SOURCES.md.
+export const obv3FoodAllergenFacilitator: CredentialFixture = {
+    id: 'obv3/food-allergen-facilitator',
+    name: 'Food Allergen Control Facilitation',
+    description:
+        'Matched teaching-performance assessment with an instructor role and O*NET Instructing alignment.',
+    spec: 'obv3',
+    profile: 'generic',
+    features: ['evidence', 'alignment', 'results', 'expiration'],
+    source: 'synthetic',
+    signed: false,
+    validity: 'valid',
+    validator: UnsignedAchievementCredentialValidator,
+    tags: ['food-safety', 'instructor', 'role-scope'],
+
+    credential: {
+        '@context': [
+            'https://www.w3.org/ns/credentials/v2',
+            'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json',
+        ],
+        id: 'urn:uuid:04adda59-747f-5d5b-b287-1a9b1943b2ba',
+        type: ['VerifiableCredential', 'OpenBadgeCredential'],
+        name: 'Teaching Food allergen control — facilitator performance',
+        description:
+            'Train a simulated food-preparation team on cross-contact communication in a fictional order. Assesses teaching performance; independent learner skill is outside this assessment.',
+        issuer: {
+            id: 'did:example:lc2184-cedar-training',
+            type: ['Profile'],
+            name: 'Cedar Technical Training',
+            url: 'https://cedar-training.example',
+        },
+        validFrom: '2026-09-01T00:00:00Z',
+        validUntil: '2028-09-01T00:00:00Z',
+        credentialSubject: {
+            id: 'https://fixtures.example.org/frenchfry/personas/d56d0c592ac6',
+            type: ['AchievementSubject'],
+            achievement: {
+                id: 'https://fixtures.example.org/frenchfry/achievements/d56d0c592ac6/facilitator',
+                type: ['Achievement'],
+                achievementType: 'Assessment',
+                name: 'Teaching Food allergen control — facilitator performance',
+                description:
+                    'Train a simulated food-preparation team on cross-contact communication in a fictional order. Assesses teaching performance; independent learner skill is outside this assessment.',
+                criteria: {
+                    narrative:
+                        'Use a shared-tool counterexample and observe whether the team escalates uncertainty without making medical claims.',
+                },
+                fieldOfStudy: 'vocational',
+                inLanguage: 'en',
+                tag: ['vocational', 'Food allergen control', 'instructor'],
+                resultDescription: [
+                    {
+                        id: 'https://fixtures.example.org/frenchfry/achievements/d56d0c592ac6/facilitator/rubric',
+                        type: ['ResultDescription'],
+                        name: 'Instruction performance',
+                        resultType: 'PerformanceLevel',
+                        allowedValue: ['Developing', 'Proficient', 'Advanced'],
+                        requiredValue: 'Proficient',
+                    },
+                ],
+                alignment: [
+                    {
+                        type: ['Alignment'],
+                        targetName: 'Instructing',
+                        targetUrl:
+                            'https://www.onetcenter.org/ctdlasn/resources/ce-07c266f7-9119-11e8-b852-782bcb5df6ac',
+                        targetFramework:
+                            'O*NET Content Model Worker Requirements - Transferable Skills: U.S. Department of Labor (DOL)',
+                        targetDescription: 'Teaching others how to do something.',
+                        targetType: 'ceasn:Competency',
+                        targetCode: '2.B.1.e',
+                    },
+                ],
+            },
+            role: 'instructor',
+            narrative:
+                'Assesses teaching performance; independent learner skill is outside this assessment.',
+            activityStartDate: '2026-08-01T00:00:00Z',
+            activityEndDate: '2026-08-31T00:00:00Z',
+            result: [
+                {
+                    type: ['Result'],
+                    resultDescription:
+                        'https://fixtures.example.org/frenchfry/achievements/d56d0c592ac6/facilitator/rubric',
+                    value: 'Proficient',
+                    status: 'Completed',
+                },
+            ],
+        },
+        evidence: [
+            {
+                id: 'https://fixtures.example.org/frenchfry/evidence/d56d0c592ac6/facilitator',
+                type: ['Evidence'],
+                name: 'Cross-contact training tabletop and communication rubric',
+                description:
+                    'Train a simulated food-preparation team on cross-contact communication in a fictional order; evaluation considered: Use a shared-tool counterexample and observe whether the team escalates uncertainty without making medical claims.',
+                narrative:
+                    'Train a simulated food-preparation team on cross-contact communication in a fictional order; evaluation considered: Use a shared-tool counterexample and observe whether the team escalates uncertainty without making medical claims.',
+                genre: 'Portfolio',
+                audience: 'Assessors',
+            },
+        ],
+    },
+};

package/src/fixtures/obv3/food-allergen-practice-fr.ts

@@ -0,0 +1,107 @@
+import { UnsignedAchievementCredentialValidator } from '@learncard/types';
+
+import type { CredentialFixture } from '../../types';
+
+// Example corpus provenance and alignment attribution: ../../../SOURCES.md.
+export const obv3FoodAllergenPracticeFr: CredentialFixture = {
+    id: 'obv3/food-allergen-practice-fr',
+    name: 'Prévention des contacts croisés avec des allergènes',
+    description:
+        'French counterpart of the food-allergen practice assessment, retaining its RubricScore and alignment.',
+    spec: 'obv3',
+    profile: 'generic',
+    features: ['evidence', 'alignment', 'results', 'expiration'],
+    source: 'synthetic',
+    signed: false,
+    validity: 'valid',
+    validator: UnsignedAchievementCredentialValidator,
+    tags: ['food-safety', 'rubric-score', 'french', 'localization', 'learner'],
+
+    credential: {
+        '@context': [
+            'https://www.w3.org/ns/credentials/v2',
+            'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json',
+        ],
+        id: 'urn:uuid:14adf3a3-43d2-5271-90be-9812f906deef',
+        type: ['VerifiableCredential', 'OpenBadgeCredential'],
+        name: 'Prévention des contacts croisés avec des allergènes',
+        description:
+            "Évaluation d'un exercice de prévention des contacts croisés avec des allergènes.",
+        issuer: {
+            id: 'did:example:lc2184-cedar-training',
+            type: ['Profile'],
+            name: 'Cedar Technical Training',
+            url: 'https://cedar-training.example',
+        },
+        validFrom: '2026-09-01T00:00:00Z',
+        validUntil: '2028-09-01T00:00:00Z',
+        credentialSubject: {
+            id: 'https://fixtures.example.org/frenchfry/personas/d56d0c592ac6',
+            type: ['AchievementSubject'],
+            achievement: {
+                id: 'https://fixtures.example.org/frenchfry/achievements/d56d0c592ac6/practice/fr',
+                type: ['Achievement'],
+                achievementType: 'Assessment',
+                name: 'Prévention des contacts croisés avec des allergènes',
+                description:
+                    "Planifie la préparation d'une commande fictive dans un exercice de cuisine simulé.",
+                criteria: {
+                    narrative:
+                        'Repère les possibilités de contact croisé, précise les étapes de communication et signale les incertitudes sans faire de diagnostic médical.',
+                },
+                fieldOfStudy: 'vocational',
+                inLanguage: 'fr',
+                tag: ['vocational', 'Food allergen control', 'learner'],
+                resultDescription: [
+                    {
+                        id: 'https://fixtures.example.org/frenchfry/achievements/d56d0c592ac6/practice/fr/rubric',
+                        type: ['ResultDescription'],
+                        name: "Points de la grille d'observation",
+                        resultType: 'RubricScore',
+                        valueMin: '0',
+                        valueMax: '4',
+                        requiredValue: '3',
+                    },
+                ],
+                alignment: [
+                    {
+                        type: ['Alignment'],
+                        targetName: 'food safety principles',
+                        targetUrl:
+                            'http://data.europa.eu/esco/skill/3f4e4eab-a8e0-4aed-b8bb-79afe7c890e3',
+                        targetFramework: 'ESCO (requested dataset v1.2.0)',
+                        targetDescription:
+                            'Scientific background of food safety which includes preparation, handling, and storage of food to minimise the risk of foodborne illness and other health hazards.',
+                    },
+                ],
+            },
+            role: 'learner',
+            narrative:
+                "Planifie la préparation d'une commande fictive dans un exercice de cuisine simulé.",
+            activityStartDate: '2026-08-01T00:00:00Z',
+            activityEndDate: '2026-08-31T00:00:00Z',
+            result: [
+                {
+                    type: ['Result'],
+                    resultDescription:
+                        'https://fixtures.example.org/frenchfry/achievements/d56d0c592ac6/practice/fr/rubric',
+                    value: '4',
+                    status: 'Completed',
+                },
+            ],
+        },
+        evidence: [
+            {
+                id: 'https://fixtures.example.org/frenchfry/evidence/d56d0c592ac6/practice/fr',
+                type: ['Evidence'],
+                name: "Liste de contrôle et compte rendu d'un exercice de simulation",
+                description:
+                    "Planifie la préparation d'une commande fictive dans un exercice de cuisine simulé.",
+                narrative:
+                    "Planifie la préparation d'une commande fictive dans un exercice de cuisine simulé.",
+                genre: "Compte rendu d'observation",
+                audience: 'Évaluateurs',
+            },
+        ],
+    },
+};

package/src/fixtures/obv3/food-allergen-practice.ts

@@ -0,0 +1,105 @@
+import { UnsignedAchievementCredentialValidator } from '@learncard/types';
+
+import type { CredentialFixture } from '../../types';
+
+// Example corpus provenance and alignment attribution: ../../../SOURCES.md.
+export const obv3FoodAllergenPractice: CredentialFixture = {
+    id: 'obv3/food-allergen-practice',
+    name: 'Food Allergen Control Practice',
+    description:
+        'Observed food-preparation practice with a RubricScore result, evidence, and ESCO alignment.',
+    spec: 'obv3',
+    profile: 'generic',
+    features: ['evidence', 'alignment', 'results', 'expiration'],
+    source: 'synthetic',
+    signed: false,
+    validity: 'valid',
+    validator: UnsignedAchievementCredentialValidator,
+    tags: ['food-safety', 'rubric-score', 'learner'],
+
+    credential: {
+        '@context': [
+            'https://www.w3.org/ns/credentials/v2',
+            'https://purl.imsglobal.org/spec/ob/v3p0/context-3.0.3.json',
+        ],
+        id: 'urn:uuid:7cc497f9-092a-5ea2-8cdb-7a2e60c25e68',
+        type: ['VerifiableCredential', 'OpenBadgeCredential'],
+        name: 'Food allergen control — observed practice',
+        description:
+            'Plan preparation for a fictional allergen-sensitive order. Demonstrate a controlled practice task with observer feedback.',
+        issuer: {
+            id: 'did:example:lc2184-cedar-training',
+            type: ['Profile'],
+            name: 'Cedar Technical Training',
+            url: 'https://cedar-training.example',
+        },
+        validFrom: '2026-09-01T00:00:00Z',
+        validUntil: '2028-09-01T00:00:00Z',
+        credentialSubject: {
+            id: 'https://fixtures.example.org/frenchfry/personas/d56d0c592ac6',
+            type: ['AchievementSubject'],
+            achievement: {
+                id: 'https://fixtures.example.org/frenchfry/achievements/d56d0c592ac6/practice',
+                type: ['Achievement'],
+                achievementType: 'Assessment',
+                name: 'Food allergen control — observed practice',
+                description:
+                    'Plan preparation for a fictional allergen-sensitive order. Demonstrate a controlled practice task with observer feedback.',
+                criteria: {
+                    narrative: 'Identify cross-contact routes and communication steps',
+                },
+                fieldOfStudy: 'vocational',
+                inLanguage: 'en',
+                tag: ['vocational', 'Food allergen control', 'learner'],
+                resultDescription: [
+                    {
+                        id: 'https://fixtures.example.org/frenchfry/achievements/d56d0c592ac6/practice/rubric',
+                        type: ['ResultDescription'],
+                        name: 'Observed task rubric points',
+                        resultType: 'RubricScore',
+                        valueMin: '0',
+                        valueMax: '4',
+                        requiredValue: '3',
+                    },
+                ],
+                alignment: [
+                    {
+                        type: ['Alignment'],
+                        targetName: 'food safety principles',
+                        targetUrl:
+                            'http://data.europa.eu/esco/skill/3f4e4eab-a8e0-4aed-b8bb-79afe7c890e3',
+                        targetFramework: 'ESCO (requested dataset v1.2.0)',
+                        targetDescription:
+                            'Scientific background of food safety which includes preparation, handling, and storage of food to minimise the risk of foodborne illness and other health hazards.',
+                    },
+                ],
+            },
+            role: 'learner',
+            narrative: 'Demonstrate a controlled practice task with observer feedback.',
+            activityStartDate: '2026-08-01T00:00:00Z',
+            activityEndDate: '2026-08-31T00:00:00Z',
+            result: [
+                {
+                    type: ['Result'],
+                    resultDescription:
+                        'https://fixtures.example.org/frenchfry/achievements/d56d0c592ac6/practice/rubric',
+                    value: '4',
+                    status: 'Completed',
+                },
+            ],
+        },
+        evidence: [
+            {
+                id: 'https://fixtures.example.org/frenchfry/evidence/d56d0c592ac6/practice',
+                type: ['Evidence'],
+                name: 'Kitchen simulation checklist',
+                description:
+                    'Plan preparation for a fictional allergen-sensitive order; evaluation considered: Identify cross-contact routes and communication steps',
+                narrative:
+                    'Plan preparation for a fictional allergen-sensitive order; evaluation considered: Identify cross-contact routes and communication steps',
+                genre: 'Observation record',
+                audience: 'Assessors',
+            },
+        ],
+    },
+};