@x12i/memorix-hippox 1.0.0

package/dist/validation.js

@@ -0,0 +1,107 @@
+const VALID_DIRECTIONS = new Set(['downstream', 'upstream']);
+const VALID_STATUSES = new Set(['draft', 'simulated', 'approved', 'disabled']);
+const VALID_JOIN_OPS = new Set(['eq', 'ne', 'in', 'nin']);
+const VALID_FILTER_OPS = new Set(['eq', 'ne', 'in', 'nin', 'exists', 'gt', 'gte', 'lt', 'lte']);
+const VALID_OUTPUT_MODES = new Set(['data', 'record', 'dataWithRecordId']);
+export class HippoxValidationError extends Error {
+    statusCode = 400;
+    constructor(message) {
+        super(message);
+        this.name = 'HippoxValidationError';
+    }
+}
+function assertNonEmptyString(value, label) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new HippoxValidationError(`${label} is required`);
+    }
+    return value.trim();
+}
+function validateRetrieval(retrieval) {
+    if (!retrieval || typeof retrieval !== 'object') {
+        throw new HippoxValidationError('retrieval is required');
+    }
+    if (retrieval.type === 'record') {
+        if (retrieval.outputMode && !VALID_OUTPUT_MODES.has(retrieval.outputMode)) {
+            throw new HippoxValidationError(`invalid record outputMode: ${retrieval.outputMode}`);
+        }
+        return retrieval;
+    }
+    if (retrieval.type === 'list') {
+        if (retrieval.outputMode && !VALID_OUTPUT_MODES.has(retrieval.outputMode)) {
+            throw new HippoxValidationError(`invalid list outputMode: ${retrieval.outputMode}`);
+        }
+        if (retrieval.limit !== undefined && (!Number.isFinite(retrieval.limit) || retrieval.limit <= 0)) {
+            throw new HippoxValidationError('list retrieval limit must be a positive number');
+        }
+        return retrieval;
+    }
+    if (retrieval.type === 'aggregate') {
+        if (!Array.isArray(retrieval.properties) || retrieval.properties.length === 0) {
+            throw new HippoxValidationError('aggregate retrieval requires at least one property path');
+        }
+        for (const path of retrieval.properties) {
+            assertNonEmptyString(path, 'aggregate property path');
+        }
+        return retrieval;
+    }
+    throw new HippoxValidationError('retrieval.type must be record, list, or aggregate');
+}
+export function validateContextLinkInput(input) {
+    const sourceObjectType = assertNonEmptyString(input.sourceObjectType, 'sourceObjectType');
+    const targetObjectType = assertNonEmptyString(input.targetObjectType, 'targetObjectType');
+    const direction = assertNonEmptyString(input.direction, 'direction');
+    if (!VALID_DIRECTIONS.has(direction)) {
+        throw new HippoxValidationError(`invalid direction: ${direction}`);
+    }
+    if (input.status && !VALID_STATUSES.has(input.status)) {
+        throw new HippoxValidationError(`invalid status: ${input.status}`);
+    }
+    if (!Array.isArray(input.join) || input.join.length === 0) {
+        throw new HippoxValidationError('join requires at least one mapping');
+    }
+    for (const mapping of input.join) {
+        assertNonEmptyString(mapping.sourcePath, 'join.sourcePath');
+        assertNonEmptyString(mapping.targetPath, 'join.targetPath');
+        const op = mapping.operator ?? 'eq';
+        if (!VALID_JOIN_OPS.has(op)) {
+            throw new HippoxValidationError(`invalid join operator: ${op}`);
+        }
+    }
+    for (const filter of input.fixedFilters ?? []) {
+        assertNonEmptyString(filter.targetPath, 'fixedFilters.targetPath');
+        if (!VALID_FILTER_OPS.has(filter.operator)) {
+            throw new HippoxValidationError(`invalid fixed filter operator: ${filter.operator}`);
+        }
+    }
+    const retrieval = validateRetrieval(input.retrieval);
+    return {
+        ...input,
+        sourceObjectType,
+        targetObjectType,
+        direction: direction,
+        join: input.join,
+        retrieval,
+    };
+}
+export function defaultRecordRetrieval() {
+    return { type: 'record', outputMode: 'data' };
+}
+export function defaultListRetrieval(limit) {
+    return { type: 'list', outputMode: 'data', limit };
+}
+export function contextKeyForLink(link) {
+    return link.alias?.trim() || link.targetObjectType;
+}
+export function detectContextKeyCollisions(links) {
+    const seen = new Map();
+    for (const link of links) {
+        const key = contextKeyForLink(link);
+        const existing = seen.get(key);
+        if (existing && existing !== link.id) {
+            return key;
+        }
+        seen.set(key, link.id ?? key);
+    }
+    return null;
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@x12i/memorix-hippox",
+  "version": "1.0.0",
+  "description": "Memorix Hippox: discover, simulate, persist, and resolve contextual relationships between Memorix object types.",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./http": {
+      "types": "./dist/http/register-routes.d.ts",
+      "import": "./dist/http/register-routes.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "node -e \"import('node:fs').then(fs=>fs.promises.rm('dist',{recursive:true,force:true}))\"",
+    "prepack": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@x12i/memorix-mongo": "^1.4.0",
+    "@x12i/memorix-retrieval": "^1.19.0",
+    "mongodb": "^6.21.0"
+  },
+  "peerDependencies": {
+    "fastify": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "fastify": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "fastify": "^5.8.5",
+    "typescript": "^5.7.2",
+    "vitest": "^3.0.0"
+  },
+  "keywords": [
+    "exellix",
+    "memorix",
+    "hippox",
+    "context-links",
+    "job-memory"
+  ],
+  "license": "exellix-license",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/x12i/memorix-mono-repo.git",
+    "directory": "memorix-hippox"
+  }
+}