@vorionsys/platform-core 0.1.0

package/dist/common/errors.js

@@ -0,0 +1,349 @@
+/**
+ * Typed Error Classes for Vorion
+ *
+ * Provides structured error types with HTTP status codes for better error handling,
+ * observability, and programmatic error discrimination.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Base error class for all Vorion errors.
+ * Extends Error with structured metadata for API responses and logging.
+ */
+export class VorionError extends Error {
+    /** Error code for programmatic identification */
+    code;
+    /** HTTP status code for API responses */
+    statusCode;
+    /** Additional error details for debugging */
+    details;
+    constructor(message, details) {
+        super(message);
+        this.name = 'VorionError';
+        this.code = 'VORION_ERROR';
+        this.statusCode = 500;
+        if (details !== undefined) {
+            this.details = details;
+        }
+        // Maintains proper stack trace for where our error was thrown (V8 engines)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Convert error to a JSON-serializable object for API responses
+     */
+    toJSON() {
+        const json = {
+            code: this.code,
+            message: this.message,
+        };
+        if (this.details) {
+            json.details = this.details;
+        }
+        return json;
+    }
+}
+/**
+ * Validation error for invalid input data.
+ * HTTP 400 Bad Request
+ */
+export class ValidationError extends VorionError {
+    code = 'VALIDATION_ERROR';
+    statusCode = 400;
+    constructor(message, details) {
+        super(message, details);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Not found error for missing resources.
+ * HTTP 404 Not Found
+ */
+export class NotFoundError extends VorionError {
+    code = 'NOT_FOUND';
+    statusCode = 404;
+    constructor(message, details) {
+        super(message, details);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Unauthorized error for authentication failures.
+ * HTTP 401 Unauthorized
+ */
+export class UnauthorizedError extends VorionError {
+    code = 'UNAUTHORIZED';
+    statusCode = 401;
+    constructor(message, details) {
+        super(message, details);
+        this.name = 'UnauthorizedError';
+    }
+}
+/**
+ * Forbidden error for authorization failures.
+ * HTTP 403 Forbidden
+ */
+export class ForbiddenError extends VorionError {
+    code = 'FORBIDDEN';
+    statusCode = 403;
+    constructor(message, details) {
+        super(message, details);
+        this.name = 'ForbiddenError';
+    }
+}
+/**
+ * Conflict error for resource state conflicts.
+ * HTTP 409 Conflict
+ */
+export class ConflictError extends VorionError {
+    code = 'CONFLICT';
+    statusCode = 409;
+    constructor(message, details) {
+        super(message, details);
+        this.name = 'ConflictError';
+    }
+}
+/**
+ * Rate limit error when request limits are exceeded.
+ * HTTP 429 Too Many Requests
+ */
+export class RateLimitError extends VorionError {
+    code = 'RATE_LIMIT_EXCEEDED';
+    statusCode = 429;
+    /** Seconds until rate limit resets */
+    retryAfter;
+    constructor(message, retryAfter, details) {
+        super(message, details);
+        this.name = 'RateLimitError';
+        if (retryAfter !== undefined) {
+            this.retryAfter = retryAfter;
+        }
+    }
+    toJSON() {
+        const json = super.toJSON();
+        if (this.retryAfter !== undefined) {
+            json.retryAfter = this.retryAfter;
+        }
+        return json;
+    }
+}
+/**
+ * Configuration error for invalid or missing configuration.
+ * HTTP 500 Internal Server Error
+ */
+export class ConfigurationError extends VorionError {
+    code = 'CONFIGURATION_ERROR';
+    statusCode = 500;
+    constructor(message, details) {
+        super(message, details);
+        this.name = 'ConfigurationError';
+    }
+}
+/**
+ * Encryption error for encryption/decryption failures.
+ * HTTP 500 Internal Server Error
+ */
+export class EncryptionError extends VorionError {
+    code = 'ENCRYPTION_ERROR';
+    statusCode = 500;
+    constructor(message, details) {
+        super(message, details);
+        this.name = 'EncryptionError';
+    }
+}
+/**
+ * Escalation error for escalation workflow failures.
+ * HTTP 400 Bad Request
+ */
+export class EscalationError extends VorionError {
+    code = 'ESCALATION_ERROR';
+    statusCode = 400;
+    constructor(message, details) {
+        super(message, details);
+        this.name = 'EscalationError';
+    }
+}
+/**
+ * Database error for database operation failures.
+ * HTTP 500 Internal Server Error
+ */
+export class DatabaseError extends VorionError {
+    code = 'DATABASE_ERROR';
+    statusCode = 500;
+    constructor(message, details) {
+        super(message, details);
+        this.name = 'DatabaseError';
+    }
+}
+/**
+ * External service error for third-party service failures.
+ * HTTP 502 Bad Gateway
+ */
+export class ExternalServiceError extends VorionError {
+    code = 'EXTERNAL_SERVICE_ERROR';
+    statusCode = 502;
+    constructor(message, details) {
+        super(message, details);
+        this.name = 'ExternalServiceError';
+    }
+}
+/**
+ * Timeout error for operation timeouts.
+ * HTTP 504 Gateway Timeout
+ */
+export class TimeoutError extends VorionError {
+    code = 'TIMEOUT';
+    statusCode = 504;
+    constructor(message, details) {
+        super(message, details);
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * Type guard to check if an error is a VorionError
+ */
+export function isVorionError(error) {
+    return error instanceof VorionError;
+}
+/**
+ * Helper to wrap unknown errors in a VorionError
+ */
+export function wrapError(error, fallbackMessage = 'An unexpected error occurred') {
+    if (isVorionError(error)) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new VorionError(error.message, { originalError: error.name });
+    }
+    return new VorionError(fallbackMessage, { originalError: String(error) });
+}
+/**
+ * Repository error for data access layer failures.
+ * HTTP 500 Internal Server Error
+ */
+export class RepositoryError extends VorionError {
+    operation;
+    entity;
+    code = 'REPOSITORY_ERROR';
+    statusCode = 500;
+    constructor(message, operation, entity, details) {
+        super(message, { operation, entity, ...details });
+        this.operation = operation;
+        this.entity = entity;
+        this.name = 'RepositoryError';
+    }
+}
+/**
+ * Service error for business logic failures.
+ * HTTP 500 Internal Server Error
+ */
+export class ServiceError extends VorionError {
+    service;
+    operation;
+    code = 'SERVICE_ERROR';
+    statusCode = 500;
+    constructor(message, service, operation, details) {
+        super(message, { service, operation, ...details });
+        this.service = service;
+        this.operation = operation;
+        this.name = 'ServiceError';
+    }
+}
+/**
+ * Integration error for external service failures.
+ * HTTP 502 Bad Gateway
+ */
+export class IntegrationError extends VorionError {
+    integration;
+    operation;
+    code = 'INTEGRATION_ERROR';
+    statusCode = 502;
+    constructor(message, integration, operation, details) {
+        super(message, { integration, operation, ...details });
+        this.integration = integration;
+        this.operation = operation;
+        this.name = 'IntegrationError';
+    }
+}
+/**
+ * Queue error for message queue operations.
+ * HTTP 500 Internal Server Error
+ */
+export class QueueError extends VorionError {
+    queue;
+    operation;
+    code = 'QUEUE_ERROR';
+    statusCode = 500;
+    constructor(message, queue, operation, details) {
+        super(message, { queue, operation, ...details });
+        this.queue = queue;
+        this.operation = operation;
+        this.name = 'QueueError';
+    }
+}
+/**
+ * Cache error for caching layer failures.
+ * HTTP 500 Internal Server Error
+ */
+export class CacheError extends VorionError {
+    operation;
+    code = 'CACHE_ERROR';
+    statusCode = 500;
+    constructor(message, operation, details) {
+        super(message, { operation, ...details });
+        this.operation = operation;
+        this.name = 'CacheError';
+    }
+}
+/**
+ * Governance error for policy evaluation failures.
+ * HTTP 500 Internal Server Error
+ */
+export class GovernanceError extends VorionError {
+    operation;
+    code = 'GOVERNANCE_ERROR';
+    statusCode = 500;
+    constructor(message, operation, details) {
+        super(message, { operation, ...details });
+        this.operation = operation;
+        this.name = 'GovernanceError';
+    }
+}
+/**
+ * Trust engine error for trust calculation failures.
+ * HTTP 500 Internal Server Error
+ */
+export class TrustEngineError extends VorionError {
+    operation;
+    entityId;
+    code = 'TRUST_ENGINE_ERROR';
+    statusCode = 500;
+    constructor(message, operation, entityId, details) {
+        super(message, { operation, entityId, ...details });
+        this.operation = operation;
+        this.entityId = entityId;
+        this.name = 'TrustEngineError';
+    }
+}
+/**
+ * Wrap an error with operation context for better debugging.
+ * Re-throws VorionErrors with additional context, wraps other errors.
+ */
+export function wrapErrorWithContext(error, context) {
+    const wrappedDetails = {
+        operation: context.operation,
+        component: context.component,
+        ...context.details,
+    };
+    if (isVorionError(error)) {
+        // Add context to existing VorionError
+        error.details = { ...error.details, ...wrappedDetails };
+        return error;
+    }
+    if (error instanceof Error) {
+        return new VorionError(`${context.component}.${context.operation} failed: ${error.message}`, { originalError: error.name, stack: error.stack, ...wrappedDetails });
+    }
+    return new VorionError(`${context.component}.${context.operation} failed: ${String(error)}`, { originalError: String(error), ...wrappedDetails });
+}
+//# sourceMappingURL=errors.js.map

package/dist/common/errors.js.map

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

package/dist/common/expression/evaluator.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Expression Evaluator for Vorion DSL
+ *
+ * Evaluates AST nodes against a context object to produce boolean results.
+ *
+ * Features:
+ * - Dotted identifier resolution (intent.action -> context.intent.action)
+ * - Type coercion for comparisons
+ * - Null-safe evaluation
+ * - LIKE pattern matching with wildcards
+ *
+ * @packageDocumentation
+ */
+import { ASTNode } from './parser.js';
+/**
+ * Context type for evaluation
+ */
+export type EvaluationContext = Record<string, unknown>;
+/**
+ * Error thrown during evaluation
+ */
+export declare class EvaluatorError extends Error {
+    node: ASTNode;
+    context?: EvaluationContext;
+    constructor(message: string, node: ASTNode, context?: EvaluationContext);
+}
+/**
+ * Resolve a dotted path in the context object
+ *
+ * @param path - Dotted path (e.g., "intent.action")
+ * @param context - Context object to resolve against
+ * @returns The resolved value or undefined if not found
+ *
+ * @example
+ * ```ts
+ * const context = { intent: { action: 'read' } };
+ * resolvePath('intent.action', context); // 'read'
+ * resolvePath('intent.missing', context); // undefined
+ * ```
+ */
+export declare function resolvePath(path: string, context: EvaluationContext): unknown;
+/**
+ * Evaluate an AST against a context object
+ *
+ * @param ast - The AST to evaluate
+ * @param context - The context object to evaluate against
+ * @returns Boolean result of the evaluation
+ * @throws EvaluatorError if evaluation fails
+ *
+ * @example
+ * ```ts
+ * const ast = parse(tokenize("intent.action == 'read'"));
+ * const context = { intent: { action: 'read' } };
+ * evaluate(ast, context); // true
+ * ```
+ */
+export declare function evaluate(ast: ASTNode, context: EvaluationContext): boolean;
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/common/expression/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../../src/common/expression/evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,OAAO,EAUR,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAG9B,IAAI,EAAE,OAAO;IACb,OAAO,CAAC,EAAE,iBAAiB;gBAFlC,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,iBAAiB;CAKrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAiB7E;AAqTD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAG1E"}