@ajna-inc/openbadges 0.1.0

package/build/repository/StatusListRecord.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * StatusListRecord
+ *
+ * Stores issuer-side status list data including the bitstring and allocation state.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusListRecord = void 0;
+const core_1 = require("@credo-ts/core");
+class StatusListRecord extends core_1.BaseRecord {
+    constructor(props) {
+        super();
+        this.type = StatusListRecord.type;
+        if (props) {
+            this.id = props.id ?? props.listId ?? core_1.utils.uuid();
+            this.createdAt = props.createdAt ?? new Date();
+            this.updatedAt = props.updatedAt ?? new Date();
+            this.listId = props.listId;
+            this.issuerDid = props.issuerDid;
+            this.purpose = props.purpose;
+            this.bitstringBase64 = props.bitstringBase64;
+            this.capacity = props.capacity;
+            this.nextIndex = props.nextIndex;
+            this.credentialIndexMap = props.credentialIndexMap;
+            this.baseUrl = props.baseUrl;
+            this._tags = props.tags ?? {};
+        }
+        else {
+            this.id = core_1.utils.uuid();
+            this.createdAt = new Date();
+            this.updatedAt = new Date();
+            this.credentialIndexMap = {};
+            this._tags = {};
+        }
+    }
+    getTags() {
+        return {
+            ...this._tags,
+            listId: this.listId,
+            issuerDid: this.issuerDid,
+            purpose: this.purpose,
+        };
+    }
+}
+exports.StatusListRecord = StatusListRecord;
+StatusListRecord.type = 'StatusListRecord';
+//# sourceMappingURL=StatusListRecord.js.map

package/build/repository/StatusListRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusListRecord.js","sourceRoot":"","sources":["../../src/repository/StatusListRecord.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,yCAAkD;AAgClD,MAAa,gBAAiB,SAAQ,iBAA2C;IAa/E,YAAmB,KAA6B;QAC9C,KAAK,EAAE,CAAA;QAHO,SAAI,GAAG,gBAAgB,CAAC,IAAI,CAAA;QAI1C,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,IAAI,YAAK,CAAC,IAAI,EAAE,CAAA;YAClD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAA;YAC9C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAA;YAC9C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;YAC1B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAA;YAChC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;YAC5B,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAA;YAC5C,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;YAC9B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAA;YAChC,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAA;YAClD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;YAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAA;QAC/B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,EAAE,GAAG,YAAK,CAAC,IAAI,EAAE,CAAA;YACtB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAA;YAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAA;YAC3B,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAA;YAC5B,IAAI,CAAC,KAAK,GAAG,EAAE,CAAA;QACjB,CAAC;IACH,CAAC;IAEM,OAAO;QACZ,OAAO;YACL,GAAG,IAAI,CAAC,KAAK;YACb,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAA;IACH,CAAC;;AA5CH,4CA6CC;AAnCwB,qBAAI,GAAG,kBAAkB,AAArB,CAAqB"}

package/build/repository/StatusListRepository.d.ts

@@ -0,0 +1,24 @@
+/**
+ * StatusListRepository
+ *
+ * Repository for managing StatusListRecord storage and retrieval.
+ */
+import { StorageService, EventEmitter, Repository } from '@credo-ts/core';
+import type { AgentContext } from '@credo-ts/core';
+import { StatusListRecord } from './StatusListRecord';
+import type { StatusPurpose } from '../models/StatusListCredential';
+export declare class StatusListRepository extends Repository<StatusListRecord> {
+    constructor(storageService: StorageService<StatusListRecord>, eventEmitter: EventEmitter);
+    /**
+     * Find a status list by its unique list ID
+     */
+    findByListId(agentContext: AgentContext, listId: string): Promise<StatusListRecord | null>;
+    /**
+     * Find all status lists for an issuer
+     */
+    findByIssuer(agentContext: AgentContext, issuerDid: string): Promise<StatusListRecord[]>;
+    /**
+     * Find status lists by issuer and purpose
+     */
+    findByIssuerAndPurpose(agentContext: AgentContext, issuerDid: string, purpose: StatusPurpose): Promise<StatusListRecord[]>;
+}

package/build/repository/StatusListRepository.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * StatusListRepository
+ *
+ * Repository for managing StatusListRecord storage and retrieval.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusListRepository = void 0;
+const core_1 = require("@credo-ts/core");
+const StatusListRecord_1 = require("./StatusListRecord");
+let StatusListRepository = class StatusListRepository extends core_1.Repository {
+    constructor(storageService, eventEmitter) {
+        super(StatusListRecord_1.StatusListRecord, storageService, eventEmitter);
+    }
+    /**
+     * Find a status list by its unique list ID
+     */
+    async findByListId(agentContext, listId) {
+        return this.findSingleByQuery(agentContext, { listId });
+    }
+    /**
+     * Find all status lists for an issuer
+     */
+    async findByIssuer(agentContext, issuerDid) {
+        return this.findByQuery(agentContext, { issuerDid });
+    }
+    /**
+     * Find status lists by issuer and purpose
+     */
+    async findByIssuerAndPurpose(agentContext, issuerDid, purpose) {
+        return this.findByQuery(agentContext, { issuerDid, purpose });
+    }
+};
+exports.StatusListRepository = StatusListRepository;
+exports.StatusListRepository = StatusListRepository = __decorate([
+    (0, core_1.injectable)(),
+    __param(0, (0, core_1.inject)(core_1.InjectionSymbols.StorageService)),
+    __metadata("design:paramtypes", [Object, core_1.EventEmitter])
+], StatusListRepository);
+//# sourceMappingURL=StatusListRepository.js.map

package/build/repository/StatusListRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusListRepository.js","sourceRoot":"","sources":["../../src/repository/StatusListRepository.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;AAEH,yCAA+G;AAE/G,yDAAqD;AAI9C,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,iBAA4B;IACpE,YAC2C,cAAgD,EACzF,YAA0B;QAE1B,KAAK,CAAC,mCAAgB,EAAE,cAAc,EAAE,YAAY,CAAC,CAAA;IACvD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY,CAAC,YAA0B,EAAE,MAAc;QAClE,OAAO,IAAI,CAAC,iBAAiB,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IACzD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY,CAAC,YAA0B,EAAE,SAAiB;QACrE,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;IACtD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,sBAAsB,CACjC,YAA0B,EAC1B,SAAiB,EACjB,OAAsB;QAEtB,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;IAC/D,CAAC;CACF,CAAA;AAhCY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,iBAAU,GAAE;IAGR,WAAA,IAAA,aAAM,EAAC,uBAAgB,CAAC,cAAc,CAAC,CAAA;6CAC1B,mBAAY;GAHjB,oBAAoB,CAgChC"}

package/build/repository/index.d.ts

@@ -0,0 +1,18 @@
+export * from './OpenBadgeCredentialRecord';
+export * from './OpenBadgeCredentialRepository';
+export * from './OpenBadgesProfileRecord';
+export * from './OpenBadgesProfileRepository';
+export * from './OpenBadgesServiceDescriptionRecord';
+export * from './OpenBadgesServiceDescriptionRepository';
+export * from './OpenBadgesOAuthRecord';
+export * from './OpenBadgesOAuthRepository';
+export * from './OpenBadgesRevocationCacheRecord';
+export * from './OpenBadgesRevocationCacheRepository';
+export * from './OpenBadgesAuthCodeRecord';
+export * from './OpenBadgesAuthCodeRepository';
+export * from './OpenBadgesTokenRecord';
+export * from './OpenBadgesTokenRepository';
+export * from './OpenBadgesConsentRecord';
+export * from './OpenBadgesConsentRepository';
+export * from './OpenBadgesKeyBindingRecord';
+export * from './OpenBadgesKeyBindingRepository';

package/build/repository/index.js

@@ -0,0 +1,35 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./OpenBadgeCredentialRecord"), exports);
+__exportStar(require("./OpenBadgeCredentialRepository"), exports);
+__exportStar(require("./OpenBadgesProfileRecord"), exports);
+__exportStar(require("./OpenBadgesProfileRepository"), exports);
+__exportStar(require("./OpenBadgesServiceDescriptionRecord"), exports);
+__exportStar(require("./OpenBadgesServiceDescriptionRepository"), exports);
+__exportStar(require("./OpenBadgesOAuthRecord"), exports);
+__exportStar(require("./OpenBadgesOAuthRepository"), exports);
+__exportStar(require("./OpenBadgesRevocationCacheRecord"), exports);
+__exportStar(require("./OpenBadgesRevocationCacheRepository"), exports);
+__exportStar(require("./OpenBadgesAuthCodeRecord"), exports);
+__exportStar(require("./OpenBadgesAuthCodeRepository"), exports);
+__exportStar(require("./OpenBadgesTokenRecord"), exports);
+__exportStar(require("./OpenBadgesTokenRepository"), exports);
+__exportStar(require("./OpenBadgesConsentRecord"), exports);
+__exportStar(require("./OpenBadgesConsentRepository"), exports);
+__exportStar(require("./OpenBadgesKeyBindingRecord"), exports);
+__exportStar(require("./OpenBadgesKeyBindingRepository"), exports);
+//# sourceMappingURL=index.js.map

package/build/repository/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/repository/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA2C;AAC3C,kEAA+C;AAC/C,4DAAyC;AACzC,gEAA6C;AAC7C,uEAAoD;AACpD,2EAAwD;AACxD,0DAAuC;AACvC,8DAA2C;AAC3C,oEAAiD;AACjD,wEAAqD;AACrD,6DAA0C;AAC1C,iEAA8C;AAC9C,0DAAuC;AACvC,8DAA2C;AAC3C,4DAAyC;AACzC,gEAA6C;AAC7C,+DAA4C;AAC5C,mEAAgD"}

package/build/services/AchievementValidator.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Achievement Validator Service
+ *
+ * Validates Achievement structures before credential issuance according to
+ * OpenBadges 3.0 specification requirements.
+ *
+ * @see https://www.imsglobal.org/spec/ob/v3p0/#achievement
+ */
+/**
+ * Result of an achievement validation
+ */
+export interface ValidationResult {
+    /** Whether the achievement is valid */
+    valid: boolean;
+    /** Critical errors that must be fixed */
+    errors: string[];
+    /** Recommendations that don't prevent issuance */
+    warnings: string[];
+}
+/**
+ * Image object structure
+ */
+export interface AchievementImage {
+    /** URI of the image */
+    id: string;
+    /** Must be 'Image' */
+    type?: 'Image';
+    /** Caption for the image */
+    caption?: string;
+}
+/**
+ * Criteria for achieving the achievement
+ */
+export interface AchievementCriteria {
+    /** URI to criteria document */
+    id?: string;
+    /** Human-readable narrative describing how to achieve */
+    narrative?: string;
+}
+/**
+ * Alignment to external standards or frameworks
+ */
+export interface Alignment {
+    /** Must be 'Alignment' */
+    type: 'Alignment';
+    /** Name of the target standard/framework */
+    targetName: string;
+    /** URL of the target standard/framework */
+    targetUrl: string;
+    /** Description of the target */
+    targetDescription?: string;
+    /** Name of the framework */
+    targetFramework?: string;
+    /** Code within the framework */
+    targetCode?: string;
+}
+/**
+ * Related achievement reference
+ */
+export interface Related {
+    /** URI of the related achievement */
+    id: string;
+    /** Type (should include 'Related') */
+    type?: string | string[];
+    /** Optional version */
+    version?: string;
+}
+/**
+ * Result description for rubric-based achievements
+ */
+export interface ResultDescription {
+    /** URI for this result description */
+    id: string;
+    /** Must be 'ResultDescription' */
+    type: 'ResultDescription';
+    /** Name of the result */
+    name: string;
+    /** Rubric criteria text */
+    resultType?: string;
+}
+/**
+ * Achievement structure as per OpenBadges 3.0 spec
+ */
+export interface Achievement {
+    /** Must include 'Achievement' */
+    type: 'Achievement' | ['Achievement', ...string[]];
+    /** URI identifying this achievement */
+    id?: string;
+    /** Name of the achievement (REQUIRED) */
+    name: string;
+    /** Description of the achievement */
+    description?: string;
+    /** Criteria for earning this achievement */
+    criteria?: AchievementCriteria;
+    /** Image representing the achievement */
+    image?: AchievementImage | string;
+    /** Type of achievement (e.g., 'Certificate', 'Badge') */
+    achievementType?: string;
+    /** Alignment to external frameworks */
+    alignment?: Alignment[];
+    /** Creator/issuer of the achievement definition */
+    creator?: {
+        id: string;
+        type?: string;
+        name?: string;
+    };
+    /** Evidence requirements */
+    creditsAvailable?: number;
+    /** Human-readable code */
+    humanCode?: string;
+    /** Related achievements */
+    related?: Related[];
+    /** Result descriptions for rubrics */
+    resultDescription?: ResultDescription[];
+    /** Specialization of another achievement */
+    specialization?: string;
+    /** Tags for categorization */
+    tag?: string[];
+    /** Version of the achievement */
+    version?: string;
+}
+/**
+ * Validates Achievement structures before credential issuance
+ */
+export declare class AchievementValidator {
+    /**
+     * Validates the basic structure of an Achievement
+     * Checks for required fields and correct types
+     */
+    validateStructure(achievement: Partial<Achievement>): ValidationResult;
+    /**
+     * Validates achievement criteria
+     * Criteria must have either an id (URL) or a narrative, preferably both
+     */
+    validateCriteria(achievement: Partial<Achievement>): ValidationResult;
+    /**
+     * Validates achievement image
+     */
+    validateImage(achievement: Partial<Achievement>): ValidationResult;
+    /**
+     * Validates alignment array
+     */
+    validateAlignment(alignments: Alignment[] | undefined): ValidationResult;
+    /**
+     * Validates result descriptions (for rubric-based achievements)
+     */
+    validateResultDescriptions(resultDescriptions: ResultDescription[] | undefined): ValidationResult;
+    /**
+     * Validates all aspects of an Achievement
+     * Combines structure, criteria, image, and alignment validation
+     */
+    validateAll(achievement: Partial<Achievement>): ValidationResult;
+    /**
+     * Quick check if an achievement is minimally valid
+     * Only checks required fields, not recommendations
+     */
+    isValid(achievement: Partial<Achievement>): boolean;
+}

package/build/services/AchievementValidator.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * Achievement Validator Service
+ *
+ * Validates Achievement structures before credential issuance according to
+ * OpenBadges 3.0 specification requirements.
+ *
+ * @see https://www.imsglobal.org/spec/ob/v3p0/#achievement
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AchievementValidator = void 0;
+const core_1 = require("@credo-ts/core");
+/**
+ * URL validation regex
+ */
+const URL_REGEX = /^(https?|urn):\/?\/?[^\s]+$/i;
+/**
+ * Validates Achievement structures before credential issuance
+ */
+let AchievementValidator = class AchievementValidator {
+    /**
+     * Validates the basic structure of an Achievement
+     * Checks for required fields and correct types
+     */
+    validateStructure(achievement) {
+        const errors = [];
+        const warnings = [];
+        // Required field: name
+        if (!achievement.name || typeof achievement.name !== 'string') {
+            errors.push('Achievement.name is required and must be a string');
+        }
+        else if (achievement.name.trim().length === 0) {
+            errors.push('Achievement.name must not be empty');
+        }
+        // Required field: type must include 'Achievement'
+        if (!achievement.type) {
+            errors.push('Achievement.type is required');
+        }
+        else {
+            const types = Array.isArray(achievement.type) ? achievement.type : [achievement.type];
+            if (!types.includes('Achievement')) {
+                errors.push("Achievement.type must include 'Achievement'");
+            }
+        }
+        // Recommended: id
+        if (!achievement.id) {
+            warnings.push('Achievement.id is recommended for persistent identification');
+        }
+        else if (typeof achievement.id === 'string' && !URL_REGEX.test(achievement.id)) {
+            warnings.push('Achievement.id should be a valid URI (URL or URN)');
+        }
+        // Recommended: description
+        if (!achievement.description) {
+            warnings.push('Achievement.description is recommended for accessibility');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validates achievement criteria
+     * Criteria must have either an id (URL) or a narrative, preferably both
+     */
+    validateCriteria(achievement) {
+        const errors = [];
+        const warnings = [];
+        if (!achievement.criteria) {
+            warnings.push('Achievement.criteria is recommended');
+            return { valid: true, errors, warnings };
+        }
+        const criteria = achievement.criteria;
+        // At least one of id or narrative should be present
+        if (!criteria.id && !criteria.narrative) {
+            errors.push('Achievement.criteria must have either id (URL) or narrative');
+        }
+        // If id is present, validate URL format
+        if (criteria.id && !URL_REGEX.test(criteria.id)) {
+            errors.push('Achievement.criteria.id must be a valid URL');
+        }
+        // Narrative should not be empty if present
+        if (criteria.narrative !== undefined && criteria.narrative.trim().length === 0) {
+            errors.push('Achievement.criteria.narrative must not be empty if provided');
+        }
+        // Recommend having both
+        if (criteria.id && !criteria.narrative) {
+            warnings.push('Consider adding criteria.narrative for human readability');
+        }
+        if (criteria.narrative && !criteria.id) {
+            warnings.push('Consider adding criteria.id for machine-readable reference');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validates achievement image
+     */
+    validateImage(achievement) {
+        const errors = [];
+        const warnings = [];
+        if (!achievement.image) {
+            warnings.push('Achievement.image is recommended for visual representation');
+            return { valid: true, errors, warnings };
+        }
+        const image = achievement.image;
+        // Image can be a string URL or an object
+        if (typeof image === 'string') {
+            if (!URL_REGEX.test(image)) {
+                errors.push('Achievement.image must be a valid URL');
+            }
+        }
+        else if (typeof image === 'object') {
+            if (!image.id) {
+                errors.push('Achievement.image.id is required');
+            }
+            else if (!URL_REGEX.test(image.id)) {
+                errors.push('Achievement.image.id must be a valid URL');
+            }
+        }
+        else {
+            errors.push('Achievement.image must be a URL string or an Image object');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validates alignment array
+     */
+    validateAlignment(alignments) {
+        const errors = [];
+        const warnings = [];
+        if (!alignments || alignments.length === 0) {
+            return { valid: true, errors, warnings };
+        }
+        alignments.forEach((alignment, index) => {
+            const prefix = `Alignment[${index}]`;
+            // Required: type
+            if (alignment.type !== 'Alignment') {
+                errors.push(`${prefix}.type must be 'Alignment'`);
+            }
+            // Required: targetName
+            if (!alignment.targetName || typeof alignment.targetName !== 'string') {
+                errors.push(`${prefix}.targetName is required`);
+            }
+            // Required: targetUrl
+            if (!alignment.targetUrl) {
+                errors.push(`${prefix}.targetUrl is required`);
+            }
+            else if (!URL_REGEX.test(alignment.targetUrl)) {
+                errors.push(`${prefix}.targetUrl must be a valid URL`);
+            }
+            // Recommended fields
+            if (!alignment.targetDescription) {
+                warnings.push(`${prefix}.targetDescription is recommended`);
+            }
+        });
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validates result descriptions (for rubric-based achievements)
+     */
+    validateResultDescriptions(resultDescriptions) {
+        const errors = [];
+        const warnings = [];
+        if (!resultDescriptions || resultDescriptions.length === 0) {
+            return { valid: true, errors, warnings };
+        }
+        resultDescriptions.forEach((rd, index) => {
+            const prefix = `ResultDescription[${index}]`;
+            // Required: id
+            if (!rd.id) {
+                errors.push(`${prefix}.id is required`);
+            }
+            // Required: type
+            if (rd.type !== 'ResultDescription') {
+                errors.push(`${prefix}.type must be 'ResultDescription'`);
+            }
+            // Required: name
+            if (!rd.name || typeof rd.name !== 'string') {
+                errors.push(`${prefix}.name is required`);
+            }
+        });
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validates all aspects of an Achievement
+     * Combines structure, criteria, image, and alignment validation
+     */
+    validateAll(achievement) {
+        const results = [
+            this.validateStructure(achievement),
+            this.validateCriteria(achievement),
+            this.validateImage(achievement),
+            this.validateAlignment(achievement.alignment),
+            this.validateResultDescriptions(achievement.resultDescription),
+        ];
+        const errors = results.flatMap((r) => r.errors);
+        const warnings = results.flatMap((r) => r.warnings);
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Quick check if an achievement is minimally valid
+     * Only checks required fields, not recommendations
+     */
+    isValid(achievement) {
+        return this.validateAll(achievement).valid;
+    }
+};
+exports.AchievementValidator = AchievementValidator;
+exports.AchievementValidator = AchievementValidator = __decorate([
+    (0, core_1.injectable)()
+], AchievementValidator);
+//# sourceMappingURL=AchievementValidator.js.map

package/build/services/AchievementValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AchievementValidator.js","sourceRoot":"","sources":["../../src/services/AchievementValidator.ts"],"names":[],"mappings":"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"}

package/build/services/ConsumerService.d.ts

@@ -0,0 +1,24 @@
+import type { AgentContext } from '@credo-ts/core';
+import { OpenBadgesServiceDescriptionRepository } from '../repository/OpenBadgesServiceDescriptionRepository';
+import { OpenBadgesOAuthRepository } from '../repository/OpenBadgesOAuthRepository';
+import { OAuthClient } from './OAuthClient';
+export declare class ConsumerService {
+    private readonly sddRepo;
+    private readonly oauthRepo;
+    private readonly oauth;
+    constructor(sddRepo: OpenBadgesServiceDescriptionRepository, oauthRepo: OpenBadgesOAuthRepository, oauth: OAuthClient);
+    importFromUrl(agentContext: AgentContext, url: string, options?: {
+        discoveryUrl?: string;
+    }): Promise<{
+        discovery: any;
+        registration: {
+            client_id: string;
+            redirect_uris?: string[];
+            scope?: string;
+        };
+        authorizationUrl: string;
+        host: string;
+    }>;
+    ensureServiceDescription(agentContext: AgentContext, discoveryUrl: string): Promise<any>;
+    upsertToRemote(agentContext: AgentContext, baseUrl: string, credential: unknown): Promise<unknown>;
+}