@mxf-dev/core 1.0.0

package/dist/utils/validation.js

@@ -0,0 +1,471 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Validation utility for type checking and assertions.
+ * Provides configurable validation with different severity levels:
+ * - hard: throws errors (fail-fast)
+ * - soft: logs warnings
+ * - silent: performs validation without output
+ */
+import { Logger } from './Logger.js';
+// Create logger instance for validation utility
+const logger = new Logger('warn', 'Validation', 'server');
+/**
+ * Creates a validator with configurable behavior
+ * @param {ValidatorConfig} config - Configuration for validation behavior
+ * @returns Object containing type assertion functions
+ */
+export const createValidator = (config) => {
+    const { mode, label } = config;
+    const context = label ? `[${label}]` : "";
+    /**
+     * Handles validation failures based on configured mode
+     * @param {string} expected - Expected type or condition description
+     * @param {unknown} actual - Actual value received
+     * @param {string} [customMessage] - Optional custom error message
+     */
+    const handleFailure = (expected, actual, customMessage) => {
+        const message = customMessage || `${context} Expected ${expected}, got: ${actual === null ? "null" : typeof actual}`;
+        if (mode === "hard") {
+            throw new Error(message);
+        }
+        else if (mode === "soft") {
+            logger.warn(message);
+        }
+    };
+    /**
+     * Validates that a value is a string
+     * @param {unknown} value - Value to check
+     * @param {string} [customMessage] - Optional custom error message
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsString = (value, customMessage) => {
+        const valid = typeof value === "string";
+        if (!valid)
+            handleFailure("string", value, customMessage);
+        return valid;
+    };
+    /**
+     * Validates that a value is a number (and not NaN)
+     * @param {unknown} value - Value to check
+     * @param {string} [customMessage] - Optional custom error message
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsNumber = (value, customMessage) => {
+        const valid = typeof value === "number" && !Number.isNaN(value);
+        if (!valid)
+            handleFailure("number", value, customMessage);
+        return valid;
+    };
+    /**
+     * Validates that a value is a boolean
+     * @param {unknown} value - Value to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsBoolean = (value) => {
+        const valid = typeof value === "boolean";
+        if (!valid)
+            handleFailure("boolean", value);
+        return valid;
+    };
+    /**
+     * Validates that a value is a bigint
+     * @param {unknown} value - Value to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsBigInt = (value) => {
+        const valid = typeof value === "bigint";
+        if (!valid)
+            handleFailure("bigint", value);
+        return valid;
+    };
+    /**
+     * Validates that a value is a symbol
+     * @param {unknown} value - Value to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsSymbol = (value) => {
+        const valid = typeof value === "symbol";
+        if (!valid)
+            handleFailure("symbol", value);
+        return valid;
+    };
+    /**
+     * Validates that a value is a function
+     * @param {unknown} value - Value to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsFunction = (value) => {
+        const valid = typeof value === "function";
+        if (!valid)
+            handleFailure("function", value);
+        return valid;
+    };
+    /**
+     * Validates that a value is a non-null object
+     * @param {unknown} value - Value to check
+     * @param {string} [customMessage] - Optional custom error message
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsObject = (value, customMessage) => {
+        const valid = typeof value === "object" && value !== null;
+        if (!valid)
+            handleFailure("non-null object", value, customMessage);
+        return valid;
+    };
+    /**
+     * Validates that a value is null
+     * @param {unknown} value - Value to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsNull = (value) => {
+        const valid = value === null;
+        if (!valid)
+            handleFailure("null", value);
+        return valid;
+    };
+    /**
+     * Validates that a value is undefined
+     * @param {unknown} value - Value to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsUndefined = (value) => {
+        const valid = value === undefined;
+        if (!valid)
+            handleFailure("undefined", value);
+        return valid;
+    };
+    /**
+     * Validates that a value is an array
+     * @param {unknown} value - Value to check
+     * @param {string} [customMessage] - Optional custom error message
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsArray = (value, customMessage) => {
+        const valid = Array.isArray(value);
+        if (!valid)
+            handleFailure(customMessage || "array", value);
+        return valid;
+    };
+    /**
+     * Validates that a value is a non-empty string
+     * @param {unknown} value - Value to check
+     * @param {string} [customMessage] - Optional custom error message
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsNonEmptyString = (value, customMessage) => {
+        const isString = typeof value === "string";
+        const isNonEmpty = isString && value.trim().length > 0;
+        if (!isString) {
+            handleFailure("string", value, customMessage);
+            return false;
+        }
+        if (!isNonEmpty) {
+            handleFailure("non-empty string", value, customMessage);
+            return false;
+        }
+        return true;
+    };
+    /**
+     * Validates that a value is a valid UUID
+     * @param {unknown} value - Value to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsUuid = (value) => {
+        const isString = assertIsString(value);
+        if (!isString)
+            return false;
+        // UUID regex pattern
+        const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+        const valid = uuidPattern.test(value);
+        if (!valid)
+            handleFailure("valid UUID", value);
+        return valid;
+    };
+    /**
+     * Validates that a value is a valid ISO date string
+     * @param {unknown} value - Value to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsIsoDateString = (value) => {
+        const isString = assertIsString(value);
+        if (!isString)
+            return false;
+        // Try parsing as date and check validity
+        const date = new Date(value);
+        const valid = !isNaN(date.getTime()) && value.includes('T');
+        if (!valid)
+            handleFailure("ISO date string", value);
+        return valid;
+    };
+    /**
+     * Validates that an object has the specified property
+     * @param {unknown} obj - Object to check
+     * @param {string} prop - Property name to verify
+     * @returns {boolean} True if validation passes
+     */
+    const assertHasProperty = (obj, prop, customMessage) => {
+        const isObj = assertIsObject(obj);
+        if (!isObj)
+            return false;
+        const valid = prop in obj;
+        if (!valid)
+            handleFailure(`object with '${prop}' property`, `object missing '${prop}'`, customMessage);
+        return valid;
+    };
+    /**
+     * Validates message ID format (specific to the framework)
+     * @param {unknown} value - Value to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsValidMessageId = (value) => {
+        return assertIsUuid(value);
+    };
+    /**
+     * Validates that a property exists on an object and is a function
+     * @param {unknown} obj - Object to check
+     * @param {string} propertyName - Name of the property to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertHasFunction = (obj, propertyName) => {
+        // First check if the object is valid
+        if (!assertIsObject(obj)) {
+            return false;
+        }
+        // Now check if the property exists and is a function
+        const hasProperty = propertyName in obj;
+        if (!hasProperty) {
+            handleFailure(`object to have property '${propertyName}'`, `object without '${propertyName}'`);
+            return false;
+        }
+        const property = obj[propertyName];
+        const isFunction = typeof property === 'function';
+        if (!isFunction) {
+            handleFailure(`property '${propertyName}' to be a function`, `property of type ${typeof property}`);
+            return false;
+        }
+        return true;
+    };
+    /**
+     * Validates that an object has the required event payload fields
+     * @param {unknown} obj - Object to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsEventPayload = (obj) => {
+        // First check if it's an object
+        if (!assertIsObject(obj))
+            return false;
+        // Check required top-level fields for refactored event payload schema
+        const requiredFields = ['agentId', 'channelId', 'timestamp'];
+        for (const field of requiredFields) {
+            if (!(field in obj)) {
+                handleFailure(`event payload with '${field}' at top level`, `object missing top-level '${field}'`);
+                return false;
+            }
+        }
+        return true;
+    };
+    /**
+     * Validates that an object follows the control loop event payload structure
+     * @param {unknown} obj - Object to check
+     * @returns {boolean} True if validation passes
+     */
+    const assertIsControlLoopPayload = (obj) => {
+        // First validate it's a BaseEventPayload structure
+        if (!assertIsEventPayload(obj))
+            return false;
+        const payload = obj;
+        // Check that data field contains control loop specific data
+        if (!payload.data || typeof payload.data !== 'object') {
+            handleFailure(`control loop payload with 'data' as an object`, `object with invalid 'data' field`);
+            return false;
+        }
+        const dataObj = payload.data;
+        // Check required fields in control loop data - loopId is required, status is optional
+        if (!dataObj.loopId || typeof dataObj.loopId !== 'string') {
+            handleFailure(`control loop payload with 'loopId'`, typeof dataObj.loopId);
+            return false;
+        }
+        // Status is optional, but if present must be a string
+        if (dataObj.status !== undefined && typeof dataObj.status !== 'string') {
+            handleFailure(`control loop payload with 'status' as string or undefined`, typeof dataObj.status);
+            return false;
+        }
+        return true;
+    };
+    /**
+     * Assert that an object is a valid ChannelMessage
+     * @param obj The object to validate
+     * @param paramName Optional parameter name for error messages
+     * @throws Error if validation fails
+     */
+    const assertIsChannelMessage = (obj, paramName = 'channelMessage') => {
+        if (!assertIsObject(obj)) {
+            handleFailure(`${paramName} as object`, `Expected object with 'channelId' property, got: ${typeof obj}`);
+            return;
+        }
+        // Check required fields for ChannelMessage
+        if (!('toolType' in obj) || obj.toolType !== 'channelMessage') {
+            handleFailure(`${paramName} with toolType 'channelMessage'`, `Missing or invalid toolType, expected 'channelMessage', got: ${obj.toolType}`);
+            return;
+        }
+        if (!('context' in obj) || !assertIsObject(obj.context)) {
+            handleFailure(`${paramName} with context object`, `Missing or invalid context object`);
+            return;
+        }
+        if (!('channelId' in obj.context) || typeof obj.context.channelId !== 'string' || obj.context.channelId.trim() === '') {
+            handleFailure(`${paramName} with context.channelId`, `Expected object with 'channelId' property in context`);
+            return;
+        }
+    };
+    /**
+     * Assert that an object is a valid AgentMessage
+     * @param obj The object to validate
+     * @param paramName Optional parameter name for error messages
+     * @throws Error if validation fails
+     */
+    const assertIsAgentMessage = (obj, paramName = 'agentMessage') => {
+        if (!assertIsObject(obj)) {
+            handleFailure(`${paramName} as object`, `Expected object with 'receiverId' property, got: ${typeof obj}`);
+            return;
+        }
+        // Check required fields for AgentMessage
+        if (!('toolType' in obj) || obj.toolType !== 'agentMessage') {
+            handleFailure(`${paramName} with toolType 'agentMessage'`, `Missing or invalid toolType, expected 'agentMessage', got: ${obj.toolType}`);
+            return;
+        }
+        if (!('receiverId' in obj) || typeof obj.receiverId !== 'string' || obj.receiverId.trim() === '') {
+            handleFailure(`${paramName} with receiverId`, `Expected object with 'receiverId' property`);
+            return;
+        }
+    };
+    /**
+     * Generic assertion that evaluates a condition
+     * @param {boolean} condition - Condition to check
+     * @param {string} [customMessage] - Optional error message if condition fails
+     * @returns {boolean} Result of the condition
+     */
+    const assert = (condition, customMessage) => {
+        if (!condition) {
+            handleFailure("condition to be true", false, customMessage);
+        }
+        return condition;
+    };
+    /**
+     * Assert that two values are equal
+     * @param {any} actual - Actual value
+     * @param {any} expected - Expected value
+     * @param {string} [customMessage] - Optional error message
+     * @returns {boolean} True if values are equal
+     */
+    const assertEqual = (actual, expected, customMessage) => {
+        const areEqual = actual === expected;
+        if (!areEqual) {
+            handleFailure(`${expected}`, actual, customMessage || `Expected ${actual} to equal ${expected}`);
+        }
+        return areEqual;
+    };
+    /**
+     * Assert that a number is greater than or equal to a minimum value
+     * @param {number} value - Value to check
+     * @param {number} min - Minimum value
+     * @param {string} [customMessage] - Optional error message
+     * @returns {boolean} True if value is greater than or equal to min
+     */
+    const assertIsGreaterThanOrEqual = (value, min, customMessage) => {
+        const isValid = value >= min;
+        if (!isValid) {
+            handleFailure(`value >= ${min}`, value, customMessage || `Expected ${value} to be >= ${min}`);
+        }
+        return isValid;
+    };
+    /**
+     * Assert that a number is within a range
+     * @param {number} value - Value to check
+     * @param {number} min - Minimum value (inclusive)
+     * @param {number} max - Maximum value (inclusive)
+     * @param {string} [customMessage] - Optional error message
+     * @returns {boolean} True if value is within range
+     */
+    const assertIsInRange = (value, min, max, customMessage) => {
+        const isValid = value >= min && value <= max;
+        if (!isValid) {
+            handleFailure(`value between ${min} and ${max}`, value, customMessage || `Expected ${value} to be between ${min} and ${max}`);
+        }
+        return isValid;
+    };
+    return {
+        assertIsString,
+        assertIsNumber,
+        assertIsBoolean,
+        assertIsBigInt,
+        assertIsSymbol,
+        assertIsFunction,
+        assertIsObject,
+        assertIsNull,
+        assertIsUndefined,
+        assertIsArray,
+        assertIsNonEmptyString,
+        assertIsUuid,
+        assertIsIsoDateString,
+        assertHasProperty,
+        assertIsValidMessageId,
+        assertHasFunction,
+        assertIsEventPayload,
+        assertIsControlLoopPayload,
+        assertIsChannelMessage,
+        assertIsAgentMessage,
+        assert,
+        assertEqual,
+        assertIsGreaterThanOrEqual,
+        assertIsInRange
+    };
+};
+/**
+ * Creates a pre-configured validator with hard mode for strict validation
+ * @param {string} label - Optional context label for error identification
+ * @returns Validator with strict (error throwing) validation
+ */
+export const createStrictValidator = (label) => {
+    return createValidator({ mode: "hard", label });
+};
+/**
+ * Creates a pre-configured validator with soft mode for warning-only validation
+ * @param {string} label - Optional context label for warning identification
+ * @returns Validator with warning-only validation
+ */
+export const createWarningValidator = (label) => {
+    return createValidator({ mode: "soft", label });
+};
+/**
+ * Creates a pre-configured validator with silent mode for logic-only validation
+ * @param {string} label - Optional context label (not used in silent mode)
+ * @returns Validator with silent validation (no errors or warnings)
+ */
+export const createSilentValidator = (label) => {
+    return createValidator({ mode: "silent", label });
+};
+// Export the assertIsChannelMessage function for use in other modules
+export const { assertIsChannelMessage } = createStrictValidator();
+// Export the assertIsEventPayload function for use in other modules  
+export const { assertIsEventPayload } = createStrictValidator();
+// Export the assertIsAgentMessage function for use in other modules  
+export const { assertIsAgentMessage } = createStrictValidator();
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@mxf-dev/core",
+  "version": "1.0.0",
+  "description": "Model Exchange Framework core: events, schemas, types, services, and protocol contracts",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "Brad Anderson <BradA1878@pm.me>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mxf-dev/mxf",
+    "directory": "packages/core"
+  },
+  "engines": {
+    "node": ">=20.19",
+    "bun": ">=1.2"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "bun": "./src/*.ts",
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "prepublishOnly": "bun run clean && bun run build"
+  },
+  "dependencies": {
+    "@google/genai": "^0.9.0",
+    "@msgpack/msgpack": "^3.1.2",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "bcrypt": "^5.1.1",
+    "dockerode": "^4.0.2",
+    "meilisearch": "^0.53.0",
+    "mongoose": "^8.10.2",
+    "openai": "^4.95.1",
+    "puppeteer": "^24.11.2",
+    "rxjs": "^7.8.2",
+    "uuid": "^9.0.1",
+    "zod": "^3.24.3"
+  },
+  "peerDependencies": {
+    "@tensorflow/tfjs": "^4.22.0",
+    "socket.io": "^4.7.2"
+  },
+  "peerDependenciesMeta": {
+    "@tensorflow/tfjs": {
+      "optional": true
+    },
+    "socket.io": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@tensorflow/tfjs": "^4.22.0",
+    "@types/bcrypt": "^5.0.2",
+    "@types/dockerode": "^3.3.24",
+    "@types/node": "^20.10.5",
+    "socket.io": "^4.7.2",
+    "typescript": "^5.2.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}