@semiont/core 0.1.0

package/dist/config/validate-config.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Runtime Configuration Validation
+ *
+ * Uses AJV to validate configuration files against the JSON Schema at runtime.
+ * This catches invalid configurations before they cause runtime errors.
+ */
+import type { SemiontConfig } from './config.types.js';
+/**
+ * Error thrown when configuration validation fails
+ */
+export declare class ConfigValidationError extends Error {
+    readonly errors: unknown[];
+    constructor(message: string, errors: unknown[]);
+    /**
+     * Get a formatted error message with all validation failures
+     */
+    getDetailedMessage(): string;
+}
+/**
+ * Validates a configuration object against the JSON Schema
+ *
+ * @param config - The configuration object to validate
+ * @returns The validated config, typed as SemiontConfig
+ * @throws ConfigValidationError if validation fails
+ *
+ * @example
+ * ```typescript
+ * import { validateConfig } from '@semiont/core';
+ *
+ * try {
+ *   const config = validateConfig(loadedConfig);
+ *   // config is now typed and validated
+ * } catch (error) {
+ *   if (error instanceof ConfigValidationError) {
+ *     console.error(error.getDetailedMessage());
+ *   }
+ * }
+ * ```
+ */
+export declare function validateConfig(config: unknown): SemiontConfig;
+/**
+ * Type guard that checks if a configuration is valid
+ * Does not throw, returns boolean instead
+ *
+ * @param config - The configuration to check
+ * @returns True if valid, false otherwise
+ */
+export declare function isValidConfig(config: unknown): config is SemiontConfig;
+/**
+ * Get validation errors for a config without throwing
+ *
+ * @param config - The configuration to validate
+ * @returns Array of validation errors, or null if valid
+ */
+export declare function getConfigErrors(config: unknown): unknown[] | null;
+//# sourceMappingURL=validate-config.d.ts.map

package/dist/config/validate-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.d.ts","sourceRoot":"","sources":["../../src/config/validate-config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAkBvD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,MAAM,EAAE,OAAO,EAAE;gBADjC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,OAAO,EAAE;IAMnC;;OAEG;IACH,kBAAkB,IAAI,MAAM;CAiB7B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAS7D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,IAAI,CAKjE"}

package/dist/config/validate-config.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Runtime Configuration Validation
+ *
+ * Uses AJV to validate configuration files against the JSON Schema at runtime.
+ * This catches invalid configurations before they cause runtime errors.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigValidationError = void 0;
+exports.validateConfig = validateConfig;
+exports.isValidConfig = isValidConfig;
+exports.getConfigErrors = getConfigErrors;
+const ajv_1 = __importDefault(require("ajv"));
+const ajv_formats_1 = __importDefault(require("ajv-formats"));
+const config_schema_json_1 = __importDefault(require("./config.schema.json"));
+// Initialize AJV with strict schema validation
+const ajv = new ajv_1.default({
+    strict: true,
+    strictSchema: true,
+    strictNumbers: true,
+    strictTypes: true,
+    allErrors: true,
+    verbose: true,
+});
+// Add format validators (email, uri, date-time, etc.)
+(0, ajv_formats_1.default)(ajv);
+// Compile the schema once at module load
+const validate = ajv.compile(config_schema_json_1.default);
+/**
+ * Error thrown when configuration validation fails
+ */
+class ConfigValidationError extends Error {
+    errors;
+    constructor(message, errors) {
+        super(message);
+        this.errors = errors;
+        this.name = 'ConfigValidationError';
+    }
+    /**
+     * Get a formatted error message with all validation failures
+     */
+    getDetailedMessage() {
+        const lines = [this.message, ''];
+        if (Array.isArray(this.errors)) {
+            this.errors.forEach((err, idx) => {
+                lines.push(`Error ${idx + 1}:`);
+                lines.push(`  Path: ${err.instancePath || '(root)'}`);
+                lines.push(`  Message: ${err.message}`);
+                if (err.params) {
+                    lines.push(`  Details: ${JSON.stringify(err.params)}`);
+                }
+                lines.push('');
+            });
+        }
+        return lines.join('\n');
+    }
+}
+exports.ConfigValidationError = ConfigValidationError;
+/**
+ * Validates a configuration object against the JSON Schema
+ *
+ * @param config - The configuration object to validate
+ * @returns The validated config, typed as SemiontConfig
+ * @throws ConfigValidationError if validation fails
+ *
+ * @example
+ * ```typescript
+ * import { validateConfig } from '@semiont/core';
+ *
+ * try {
+ *   const config = validateConfig(loadedConfig);
+ *   // config is now typed and validated
+ * } catch (error) {
+ *   if (error instanceof ConfigValidationError) {
+ *     console.error(error.getDetailedMessage());
+ *   }
+ * }
+ * ```
+ */
+function validateConfig(config) {
+    if (!validate(config)) {
+        const errors = validate.errors || [];
+        const errorCount = errors.length;
+        const message = `Configuration validation failed with ${errorCount} error${errorCount === 1 ? '' : 's'}`;
+        throw new ConfigValidationError(message, errors);
+    }
+    return config;
+}
+/**
+ * Type guard that checks if a configuration is valid
+ * Does not throw, returns boolean instead
+ *
+ * @param config - The configuration to check
+ * @returns True if valid, false otherwise
+ */
+function isValidConfig(config) {
+    return validate(config) === true;
+}
+/**
+ * Get validation errors for a config without throwing
+ *
+ * @param config - The configuration to validate
+ * @returns Array of validation errors, or null if valid
+ */
+function getConfigErrors(config) {
+    if (validate(config)) {
+        return null;
+    }
+    return validate.errors || [];
+}
+//# sourceMappingURL=validate-config.js.map

package/dist/config/validate-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.js","sourceRoot":"","sources":["../../src/config/validate-config.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;AA8EH,wCASC;AASD,sCAEC;AAQD,0CAKC;AA7GD,8CAAsB;AACtB,8DAAqC;AACrC,8EAA0C;AAG1C,+CAA+C;AAC/C,MAAM,GAAG,GAAG,IAAI,aAAG,CAAC;IAClB,MAAM,EAAE,IAAI;IACZ,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;IACnB,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI;CACd,CAAC,CAAC;AAEH,sDAAsD;AACtD,IAAA,qBAAU,EAAC,GAAG,CAAC,CAAC;AAEhB,yCAAyC;AACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,4BAAM,CAAC,CAAC;AAErC;;GAEG;AACH,MAAa,qBAAsB,SAAQ,KAAK;IAG5B;IAFlB,YACE,OAAe,EACC,MAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAAW;QAGjC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAEjC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAQ,EAAE,GAAG,EAAE,EAAE;gBACpC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,YAAY,IAAI,QAAQ,EAAE,CAAC,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACxC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;oBACf,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACzD,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AA7BD,sDA6BC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,cAAc,CAAC,MAAe;IAC5C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;QACjC,MAAM,OAAO,GAAG,wCAAwC,UAAU,SAAS,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QACzG,MAAM,IAAI,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,MAAuB,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,MAAe;IAC3C,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,MAAe;IAC7C,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/creation-methods.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resource creation methods - How resources are created in the system
+ */
+/**
+ * Enumeration of all possible resource creation methods
+ */
+export declare const CREATION_METHODS: {
+    readonly API: "api";
+    readonly UPLOAD: "upload";
+    readonly UI: "ui";
+    readonly REFERENCE: "reference";
+    readonly CLONE: "clone";
+    readonly GENERATED: "generated";
+};
+/**
+ * Type for resource creation methods
+ */
+export type CreationMethod = typeof CREATION_METHODS[keyof typeof CREATION_METHODS];
+//# sourceMappingURL=creation-methods.d.ts.map

package/dist/creation-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creation-methods.d.ts","sourceRoot":"","sources":["../src/creation-methods.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;CAOnB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/creation-methods.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Resource creation methods - How resources are created in the system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CREATION_METHODS = void 0;
+/**
+ * Enumeration of all possible resource creation methods
+ */
+exports.CREATION_METHODS = {
+    API: 'api',
+    UPLOAD: 'upload',
+    UI: 'ui',
+    REFERENCE: 'reference',
+    CLONE: 'clone',
+    GENERATED: 'generated',
+};
+//# sourceMappingURL=creation-methods.js.map

package/dist/creation-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creation-methods.js","sourceRoot":"","sources":["../src/creation-methods.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;IAChB,EAAE,EAAE,IAAI;IACR,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;CACd,CAAC"}

package/dist/crypto.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Cryptographic utilities
+ */
+/**
+ * Calculate SHA-256 checksum of content
+ * @param content The content to hash
+ * @returns Hex-encoded SHA-256 hash
+ */
+export declare function calculateChecksum(content: string | Buffer): string;
+/**
+ * Verify content against a checksum
+ * @param content The content to verify
+ * @param checksum The expected checksum
+ * @returns True if content matches checksum
+ */
+export declare function verifyChecksum(content: string | Buffer, checksum: string): boolean;
+/**
+ * Generate a random ID (12 character hex string)
+ * Similar to MongoDB ObjectId but simpler
+ */
+export declare function generateId(): string;
+/**
+ * Generate a UUID v4-like ID (without dashes)
+ */
+export declare function generateUuid(): string;
+/**
+ * Generate a secure random token
+ * @param bytes Number of random bytes (default 32)
+ * @returns Base64 encoded random token
+ */
+export declare function generateToken(bytes?: number): string;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAIlE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElF;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,CAExD"}

package/dist/crypto.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Cryptographic utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateChecksum = calculateChecksum;
+exports.verifyChecksum = verifyChecksum;
+exports.generateId = generateId;
+exports.generateUuid = generateUuid;
+exports.generateToken = generateToken;
+const crypto_1 = require("crypto");
+/**
+ * Calculate SHA-256 checksum of content
+ * @param content The content to hash
+ * @returns Hex-encoded SHA-256 hash
+ */
+function calculateChecksum(content) {
+    const hash = (0, crypto_1.createHash)('sha256');
+    hash.update(content);
+    return hash.digest('hex');
+}
+/**
+ * Verify content against a checksum
+ * @param content The content to verify
+ * @param checksum The expected checksum
+ * @returns True if content matches checksum
+ */
+function verifyChecksum(content, checksum) {
+    return calculateChecksum(content) === checksum;
+}
+/**
+ * Generate a random ID (12 character hex string)
+ * Similar to MongoDB ObjectId but simpler
+ */
+function generateId() {
+    return (0, crypto_1.randomBytes)(6).toString('hex');
+}
+/**
+ * Generate a UUID v4-like ID (without dashes)
+ */
+function generateUuid() {
+    return (0, crypto_1.randomBytes)(16).toString('hex');
+}
+/**
+ * Generate a secure random token
+ * @param bytes Number of random bytes (default 32)
+ * @returns Base64 encoded random token
+ */
+function generateToken(bytes = 32) {
+    return (0, crypto_1.randomBytes)(bytes).toString('base64url');
+}
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":";AAAA;;GAEG;;AASH,8CAIC;AAQD,wCAEC;AAMD,gCAEC;AAKD,oCAEC;AAOD,sCAEC;AA7CD,mCAAiD;AAEjD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,OAAwB;IACxD,MAAM,IAAI,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,OAAwB,EAAE,QAAgB;IACvE,OAAO,iBAAiB,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU;IACxB,OAAO,IAAA,oBAAW,EAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY;IAC1B,OAAO,IAAA,oBAAW,EAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,QAAgB,EAAE;IAC9C,OAAO,IAAA,oBAAW,EAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAClD,CAAC"}

package/dist/did-utils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * DID (Decentralized Identifier) and W3C Agent utilities
+ *
+ * Provides utilities for working with DID:WEB identifiers and converting
+ * between user representations and W3C Web Annotation Agent objects.
+ */
+import type { components } from '@semiont/api-client';
+type Agent = components['schemas']['Agent'];
+/**
+ * Convert a user object to a DID:WEB identifier
+ *
+ * Format: did:web:domain.com:users:userId
+ * Example: did:web:example.com:users:abc123
+ *
+ * This is used for W3C Web Annotation compliance and federation readiness.
+ *
+ * @param user - User object with id and domain
+ * @returns DID:WEB identifier string
+ */
+export declare function userToDid(user: {
+    id: string;
+    domain: string;
+}): string;
+/**
+ * Convert a user object to a W3C Agent object with DID:WEB identifier
+ *
+ * Creates a full Agent object for W3C Web Annotation compliance.
+ * Includes DID:WEB identifier, type, and name.
+ *
+ * @param user - User object with id, domain, name, and email
+ * @returns W3C Agent object
+ */
+export declare function userToAgent(user: {
+    id: string;
+    domain: string;
+    name: string | null;
+    email: string;
+}): Agent;
+/**
+ * Convert a DID string to a minimal W3C Agent object
+ *
+ * Used when reconstructing annotations from events where only the DID is available.
+ * Creates a minimal Agent with just the required fields (id, type).
+ * Name is derived from the DID for display purposes.
+ *
+ * @param did - DID:WEB identifier string
+ * @returns Minimal W3C Agent object
+ */
+export declare function didToAgent(did: string): Agent;
+export {};
+//# sourceMappingURL=did-utils.d.ts.map

package/dist/did-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-utils.d.ts","sourceRoot":"","sources":["../src/did-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,KAAK,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,KAAK,CAMR;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAU7C"}

package/dist/did-utils.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * DID (Decentralized Identifier) and W3C Agent utilities
+ *
+ * Provides utilities for working with DID:WEB identifiers and converting
+ * between user representations and W3C Web Annotation Agent objects.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userToDid = userToDid;
+exports.userToAgent = userToAgent;
+exports.didToAgent = didToAgent;
+/**
+ * Convert a user object to a DID:WEB identifier
+ *
+ * Format: did:web:domain.com:users:userId
+ * Example: did:web:example.com:users:abc123
+ *
+ * This is used for W3C Web Annotation compliance and federation readiness.
+ *
+ * @param user - User object with id and domain
+ * @returns DID:WEB identifier string
+ */
+function userToDid(user) {
+    return `did:web:${user.domain}:users:${user.id}`;
+}
+/**
+ * Convert a user object to a W3C Agent object with DID:WEB identifier
+ *
+ * Creates a full Agent object for W3C Web Annotation compliance.
+ * Includes DID:WEB identifier, type, and name.
+ *
+ * @param user - User object with id, domain, name, and email
+ * @returns W3C Agent object
+ */
+function userToAgent(user) {
+    return {
+        type: 'Person',
+        id: userToDid(user),
+        name: user.name || user.email,
+    };
+}
+/**
+ * Convert a DID string to a minimal W3C Agent object
+ *
+ * Used when reconstructing annotations from events where only the DID is available.
+ * Creates a minimal Agent with just the required fields (id, type).
+ * Name is derived from the DID for display purposes.
+ *
+ * @param did - DID:WEB identifier string
+ * @returns Minimal W3C Agent object
+ */
+function didToAgent(did) {
+    // Extract user ID from DID format: did:web:domain.com:users:userId
+    const parts = did.split(':');
+    const userId = parts[parts.length - 1] || 'unknown';
+    return {
+        type: 'Person',
+        id: did,
+        name: userId, // Use user ID as name since we don't have full user data
+    };
+}
+//# sourceMappingURL=did-utils.js.map

package/dist/did-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-utils.js","sourceRoot":"","sources":["../src/did-utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAiBH,8BAEC;AAWD,kCAWC;AAYD,gCAUC;AAzDD;;;;;;;;;;GAUG;AACH,SAAgB,SAAS,CAAC,IAAoC;IAC5D,OAAO,WAAW,IAAI,CAAC,MAAM,UAAU,IAAI,CAAC,EAAE,EAAE,CAAC;AACnD,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAAC,IAK3B;IACC,OAAO;QACL,IAAI,EAAE,QAAiB;QACvB,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK;KAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,mEAAmE;IACnE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;IAEpD,OAAO;QACL,IAAI,EAAE,QAAiB;QACvB,EAAE,EAAE,GAAG;QACP,IAAI,EAAE,MAAM,EAAE,yDAAyD;KACxE,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Common error classes
+ */
+/**
+ * Base error class for Semiont applications
+ */
+export declare class SemiontError extends Error {
+    code: string;
+    details?: Record<string, any> | undefined;
+    constructor(message: string, code: string, details?: Record<string, any> | undefined);
+}
+/**
+ * Error thrown when validation fails
+ */
+export declare class ValidationError extends SemiontError {
+    constructor(message: string, details?: Record<string, any>);
+}
+/**
+ * Error thrown by scripts
+ */
+export declare class ScriptError extends SemiontError {
+    constructor(message: string, code?: string, details?: Record<string, any>);
+}
+/**
+ * Error thrown when a resource is not found
+ */
+export declare class NotFoundError extends SemiontError {
+    constructor(resource: string, id?: string);
+}
+/**
+ * Error thrown when user is not authorized
+ */
+export declare class UnauthorizedError extends SemiontError {
+    constructor(message?: string, details?: Record<string, any>);
+}
+/**
+ * Error thrown when operation would conflict with existing data
+ */
+export declare class ConflictError extends SemiontError {
+    constructor(message: string, details?: Record<string, any>);
+}
+/**
+ * API Error class for handling HTTP errors
+ * Used by API clients to represent failed HTTP requests
+ */
+export declare class APIError extends Error {
+    status: number;
+    data: any;
+    constructor(status: number, data: any, message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAG5B,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;gBAFpC,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAA;CAMvC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAI3D;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAuB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAI1F;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;gBACjC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM;CAK1C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;gBACrC,OAAO,GAAE,MAAuB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAI5E;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAI3D;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAExB,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,GAAG;gBADT,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,GAAG,EAChB,OAAO,CAAC,EAAE,MAAM;CAMnB"}

package/dist/errors.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Common error classes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APIError = exports.ConflictError = exports.UnauthorizedError = exports.NotFoundError = exports.ScriptError = exports.ValidationError = exports.SemiontError = void 0;
+/**
+ * Base error class for Semiont applications
+ */
+class SemiontError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'SemiontError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.SemiontError = SemiontError;
+/**
+ * Error thrown when validation fails
+ */
+class ValidationError extends SemiontError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', details);
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Error thrown by scripts
+ */
+class ScriptError extends SemiontError {
+    constructor(message, code = 'SCRIPT_ERROR', details) {
+        super(message, code, details);
+        this.name = 'ScriptError';
+    }
+}
+exports.ScriptError = ScriptError;
+/**
+ * Error thrown when a resource is not found
+ */
+class NotFoundError extends SemiontError {
+    constructor(resource, id) {
+        const message = id ? `${resource} with id '${id}' not found` : `${resource} not found`;
+        super(message, 'NOT_FOUND', { resource, id });
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+/**
+ * Error thrown when user is not authorized
+ */
+class UnauthorizedError extends SemiontError {
+    constructor(message = 'Unauthorized', details) {
+        super(message, 'UNAUTHORIZED', details);
+        this.name = 'UnauthorizedError';
+    }
+}
+exports.UnauthorizedError = UnauthorizedError;
+/**
+ * Error thrown when operation would conflict with existing data
+ */
+class ConflictError extends SemiontError {
+    constructor(message, details) {
+        super(message, 'CONFLICT', details);
+        this.name = 'ConflictError';
+    }
+}
+exports.ConflictError = ConflictError;
+/**
+ * API Error class for handling HTTP errors
+ * Used by API clients to represent failed HTTP requests
+ */
+class APIError extends Error {
+    status;
+    data;
+    constructor(status, data, message) {
+        super(message || `API Error: ${status}`);
+        this.status = status;
+        this.data = data;
+        this.name = 'APIError';
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.APIError = APIError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IAG5B;IACA;IAHT,YACE,OAAe,EACR,IAAY,EACZ,OAA6B;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAsB;QAGpC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAVD,oCAUC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED;;GAEG;AACH,MAAa,WAAY,SAAQ,YAAY;IAC3C,YAAY,OAAe,EAAE,OAAe,cAAc,EAAE,OAA6B;QACvF,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AALD,kCAKC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,YAAY;IAC7C,YAAY,QAAgB,EAAE,EAAW;QACvC,MAAM,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,QAAQ,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,YAAY,CAAC;QACvF,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAND,sCAMC;AAED;;GAEG;AACH,MAAa,iBAAkB,SAAQ,YAAY;IACjD,YAAY,UAAkB,cAAc,EAAE,OAA6B;QACzE,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AALD,8CAKC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,YAAY;IAC7C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED;;;GAGG;AACH,MAAa,QAAS,SAAQ,KAAK;IAExB;IACA;IAFT,YACS,MAAc,EACd,IAAS,EAChB,OAAgB;QAEhB,KAAK,CAAC,OAAO,IAAI,cAAc,MAAM,EAAE,CAAC,CAAC;QAJlC,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAK;QAIhB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAVD,4BAUC"}