@semiont/core 0.1.0 → 0.2.0-build.4

package/README.md

@@ -1,5 +1,9 @@
 # @semiont/core
 
+[![npm version](https://img.shields.io/npm/v/@semiont/core.svg)](https://www.npmjs.com/package/@semiont/core)
+[![npm downloads](https://img.shields.io/npm/dm/@semiont/core.svg)](https://www.npmjs.com/package/@semiont/core)
+[![License](https://img.shields.io/npm/l/@semiont/core.svg)](https://github.com/The-AI-Alliance/semiont/blob/main/LICENSE)
+
 Backend domain logic for the Semiont semantic knowledge platform. This package provides **internal backend utilities** for event sourcing, cryptography, DID generation, and type guards.
 
 > ⚠️ **Not for External Use**: If you're building applications that consume the Semiont API, use [`@semiont/api-client`](../api-client/README.md) instead. This package is for **backend internal use only**.
@@ -19,10 +23,18 @@ Backend domain logic for the Semiont semantic knowledge platform. This package p
 
 ## Installation
 
+Install the latest stable release from npm:
+
 ```bash
 npm install @semiont/core
 ```
 
+Or install the latest development build:
+
+```bash
+npm install @semiont/core@dev
+```
+
 ## What's Included
 
 ### Event Sourcing Types

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semiont/core",
-  "version": "0.1.0",
+  "version": "0.2.0-build.4",
   "description": "Core domain types for Semiont - Document, Annotation, and Graph models",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

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

@@ -1,56 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,114 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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"}