@x12i/memorix-hippox 1.0.0

package/dist/legacy-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-bridge.d.ts","sourceRoot":"","sources":["../src/legacy-bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGzF,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,GAAG;IAC3D,kBAAkB,CAAC,EAAE,cAAc,EAAE,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,GAAG;IAC9E,KAAK,EAAE,wBAAwB,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,oBAAoB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAiCtE;AASD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC,CAUjE"}

package/dist/legacy-bridge.js

@@ -0,0 +1,53 @@
+import { resolveJobMemoryFromLinks, } from '@x12i/memorix-mongo';
+import { resolveContext } from './resolve.js';
+/**
+ * Resolve Hippox approved links into object-keyed `jobMemory.context` and optionally
+ * merge legacy relation-based context entries under `_legacy`.
+ */
+export async function resolveMixedContext(options) {
+    const { retrieval, store, input, processEnv } = options;
+    const hippoxResult = await resolveContext({
+        retrieval,
+        store,
+        processEnv,
+        input,
+    });
+    if (!input.legacyContextLinks?.length) {
+        return hippoxResult;
+    }
+    const sourceEntity = input.sourceEntity
+        ?? input.sourceObjectType
+        ?? inferSourceEntity(input.sourceRecord);
+    if (!sourceEntity) {
+        throw new Error('sourceEntity is required when resolving legacy context links');
+    }
+    const sourceRecord = input.sourceRecord ?? {};
+    const legacyJobMemory = await resolveJobMemoryFromLinks(retrieval, {
+        input: sourceRecord,
+        sourceEntity,
+        contextLinks: input.legacyContextLinks,
+    });
+    return {
+        ...hippoxResult,
+        legacy: legacyJobMemory,
+    };
+}
+function inferSourceEntity(record) {
+    const ref = record?._memorixRef;
+    if (!ref || typeof ref !== 'object' || Array.isArray(ref))
+        return undefined;
+    const entityName = ref.entityName;
+    return typeof entityName === 'string' && entityName.trim() ? entityName.trim() : undefined;
+}
+export function hippoxLinkFromRelationCandidate(params) {
+    return {
+        sourceObjectType: params.sourceEntity,
+        targetObjectType: params.targetEntity,
+        direction: 'downstream',
+        sourceContentType: params.sourceContentType,
+        targetContentType: params.targetContentType,
+        join: [{ sourcePath: params.sourcePath, targetPath: params.targetPath, operator: 'eq' }],
+        retrieval: { type: 'record', outputMode: 'data' },
+    };
+}
+//# sourceMappingURL=legacy-bridge.js.map

package/dist/legacy-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-bridge.js","sourceRoot":"","sources":["../src/legacy-bridge.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,GAE1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAA8B,MAAM,cAAc,CAAC;AAa1E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAmC;IAEnC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC;QACxC,SAAS;QACT,KAAK;QACL,UAAU;QACV,KAAK;KACN,CAAC,CAAC;IAEH,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,MAAM,EAAE,CAAC;QACtC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,YAAY,GAChB,KAAK,CAAC,YAAY;WACf,KAAK,CAAC,gBAAgB;WACtB,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAE3C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;IAC9C,MAAM,eAAe,GAAG,MAAM,yBAAyB,CAAC,SAAS,EAAE;QACjE,KAAK,EAAE,YAAY;QACnB,YAAY;QACZ,YAAY,EAAE,KAAK,CAAC,kBAAkB;KACvC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,YAAY;QACf,MAAM,EAAE,eAAe;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAgC;IACzD,MAAM,GAAG,GAAG,MAAM,EAAE,WAAW,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5E,MAAM,UAAU,GAAI,GAA+B,CAAC,UAAU,CAAC;IAC/D,OAAO,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,MAQ/C;IACC,OAAO;QACL,gBAAgB,EAAE,MAAM,CAAC,YAAY;QACrC,gBAAgB,EAAE,MAAM,CAAC,YAAY;QACrC,SAAS,EAAE,YAAY;QACvB,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACxF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE;KAClD,CAAC;AACJ,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,15 @@
+/** Read a nested dot-path from a plain object. */
+export declare function readPath(doc: Record<string, unknown>, path: string): unknown;
+export declare function readRecordId(doc: Record<string, unknown>): string;
+export declare function isDateLike(value: unknown): boolean;
+export declare function coerceDateValue(value: unknown): Date | unknown;
+export declare function sortSpecsToMongo(specs: Array<{
+    path: string;
+    direction: 'asc' | 'desc';
+}> | undefined, fallback: Array<{
+    path: string;
+    direction: 'asc' | 'desc';
+}>): Record<string, 1 | -1>;
+export declare function extractDataPayload(doc: Record<string, unknown>): Record<string, unknown>;
+export declare function formatOutputRecord(doc: Record<string, unknown>, mode: 'data' | 'record' | 'dataWithRecordId'): unknown;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAY5E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAiBjE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOlD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAI9D;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,EACrE,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAAC,GAC3D,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAOxB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMxF;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,kBAAkB,GAC3C,OAAO,CAOT"}

package/dist/paths.js

@@ -0,0 +1,79 @@
+/** Read a nested dot-path from a plain object. */
+export function readPath(doc, path) {
+    const trimmed = path.trim();
+    if (!trimmed)
+        return undefined;
+    if (!trimmed.includes('.'))
+        return doc[trimmed];
+    let current = doc;
+    for (const segment of trimmed.split('.')) {
+        if (current === null || current === undefined || typeof current !== 'object' || Array.isArray(current)) {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+export function readRecordId(doc) {
+    const candidates = [
+        doc._id,
+        doc.recordId,
+        doc.entityId,
+        doc.eventId,
+        doc.knowledgeId,
+        readPath(doc, 'data.entityId'),
+        readPath(doc, 'data.eventId'),
+        readPath(doc, 'data.knowledgeId'),
+    ];
+    for (const value of candidates) {
+        if (value === null || value === undefined)
+            continue;
+        const str = String(value).trim();
+        if (str)
+            return str;
+    }
+    return '';
+}
+export function isDateLike(value) {
+    if (value instanceof Date)
+        return true;
+    if (typeof value !== 'string')
+        return false;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return false;
+    const parsed = Date.parse(trimmed);
+    return Number.isFinite(parsed);
+}
+export function coerceDateValue(value) {
+    if (value instanceof Date)
+        return value;
+    if (typeof value === 'string' && isDateLike(value))
+        return new Date(value);
+    return value;
+}
+export function sortSpecsToMongo(specs, fallback) {
+    const chosen = specs?.length ? specs : fallback;
+    const out = {};
+    for (const spec of chosen) {
+        out[spec.path] = spec.direction === 'asc' ? 1 : -1;
+    }
+    return out;
+}
+export function extractDataPayload(doc) {
+    const data = doc.data;
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    return doc;
+}
+export function formatOutputRecord(doc, mode) {
+    if (mode === 'record')
+        return doc;
+    const data = extractDataPayload(doc);
+    if (mode === 'dataWithRecordId') {
+        return { ...data, recordId: readRecordId(doc) };
+    }
+    return data;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

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

package/dist/resolve.d.ts

@@ -0,0 +1,11 @@
+import type { MemorixRetrievalClient } from '@x12i/memorix-retrieval';
+import type { ResolveContextInput, ResolveContextResult } from './types.js';
+import type { HippoxStore } from './store.js';
+export type ResolveContextOptions = {
+    retrieval: MemorixRetrievalClient;
+    store?: HippoxStore;
+    input: ResolveContextInput;
+    processEnv?: NodeJS.ProcessEnv;
+};
+export declare function resolveContext(options: ResolveContextOptions): Promise<ResolveContextResult>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAStE,OAAO,KAAK,EAMV,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,sBAAsB,CAAC;IAClC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAChC,CAAC;AAQF,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoElG"}

package/dist/resolve.js

@@ -0,0 +1,180 @@
+import { loadHippoxConfig } from './config.js';
+import { buildTargetQueryFromLink } from './filters.js';
+import { loadSourceRecord, readObjectTypeDocuments, resolveObjectTypeCollection, } from './collection-resolver.js';
+import { readPath, readRecordId, formatOutputRecord, sortSpecsToMongo } from './paths.js';
+import { contextKeyForLink, detectContextKeyCollisions } from './validation.js';
+const DEFAULT_SCOPED_AT_SORT = [{ path: 'data.scopedAt', direction: 'desc' }];
+const FALLBACK_RECORD_SORT = [
+    { path: 'updatedAt', direction: 'desc' },
+    { path: '_id', direction: 'asc' },
+];
+export async function resolveContext(options) {
+    const { retrieval, store, input } = options;
+    const config = loadHippoxConfig(options.processEnv);
+    const links = [];
+    if (input.linkIds?.length) {
+        if (!store)
+            throw new Error('store is required when resolving by linkIds');
+        const stored = await store.getApprovedByIds(input.linkIds);
+        if (stored.length !== input.linkIds.length) {
+            const found = new Set(stored.map((l) => l.id));
+            const missing = input.linkIds.filter((id) => !found.has(id));
+            throw new Error(`approved links not found: ${missing.join(', ')}`);
+        }
+        links.push(...stored);
+    }
+    if (input.links?.length) {
+        for (const link of input.links) {
+            if (link.status !== 'approved') {
+                throw new Error(`link ${link.id} must be approved for runtime resolution`);
+            }
+            if (!links.some((existing) => existing.id === link.id)) {
+                links.push(link);
+            }
+        }
+    }
+    if (links.length === 0) {
+        return { jobMemory: { context: {} } };
+    }
+    const collision = detectContextKeyCollisions(links);
+    if (collision) {
+        throw new Error(`context key collision for "${collision}" — assign aliases or reduce links targeting the same object type`);
+    }
+    const sourceObjectType = input.sourceObjectType
+        ?? inferSourceObjectType(links)
+        ?? inferSourceObjectTypeFromRecord(input.sourceRecord);
+    if (!sourceObjectType) {
+        throw new Error('sourceObjectType could not be inferred');
+    }
+    const sourceRecord = await loadSourceRecord(retrieval, sourceObjectType, {
+        recordId: input.sourceRecordId,
+        record: input.sourceRecord,
+        contentType: links[0]?.sourceContentType,
+    });
+    const context = {};
+    const usedLinkIds = [];
+    for (const link of links) {
+        const key = contextKeyForLink(link);
+        const outputMode = input.outputMode ?? defaultOutputMode(link);
+        context[key] = await resolveLinkContext(retrieval, link, sourceRecord, outputMode, config.contextListLimit);
+        usedLinkIds.push(link.id);
+    }
+    if (store && usedLinkIds.length > 0) {
+        await store.recordUsage(usedLinkIds);
+    }
+    return { jobMemory: { context } };
+}
+function inferSourceObjectType(links) {
+    return links[0]?.sourceObjectType;
+}
+function inferSourceObjectTypeFromRecord(record) {
+    const ref = record?._memorixRef;
+    if (!ref || typeof ref !== 'object' || Array.isArray(ref))
+        return undefined;
+    const entityName = ref.entityName;
+    return typeof entityName === 'string' && entityName.trim() ? entityName.trim() : undefined;
+}
+function defaultOutputMode(link) {
+    const retrieval = link.retrieval;
+    if (retrieval.type === 'record')
+        return retrieval.outputMode ?? 'data';
+    if (retrieval.type === 'list')
+        return retrieval.outputMode ?? 'data';
+    return 'data';
+}
+async function resolveLinkContext(retrieval, link, sourceRecord, outputMode, defaultListLimit) {
+    const query = buildTargetQueryFromLink(link, sourceRecord);
+    if (!query)
+        return link.retrieval.type === 'aggregate' ? {} : null;
+    const targetBinding = await resolveObjectTypeCollection(retrieval, link.targetObjectType, link.targetContentType);
+    if (link.retrieval.type === 'record') {
+        return resolveRecordContext(retrieval, targetBinding, query, link.retrieval, outputMode);
+    }
+    if (link.retrieval.type === 'list') {
+        return resolveListContext(retrieval, targetBinding, query, link.retrieval, outputMode, defaultListLimit);
+    }
+    return resolveAggregateContext(retrieval, targetBinding, query, link.retrieval);
+}
+async function resolveRecordContext(retrieval, targetBinding, query, retrievalSpec, outputModeOverride) {
+    const dateField = retrievalSpec.dateField ?? 'data.scopedAt';
+    const sort = sortSpecsToMongo(retrievalSpec.sort, [
+        { path: dateField, direction: 'desc' },
+        ...FALLBACK_RECORD_SORT,
+    ]);
+    const docs = await readObjectTypeDocuments(retrieval, targetBinding, {
+        query,
+        limit: 25,
+        sort,
+    });
+    if (docs.length === 0)
+        return null;
+    const best = pickBestRecord(docs, dateField, sort);
+    const mode = outputModeOverride ?? retrievalSpec.outputMode ?? 'data';
+    return formatOutputRecord(best, mode);
+}
+function pickBestRecord(docs, dateField, sort) {
+    const sorted = [...docs].sort((a, b) => compareBySortSpec(a, b, sort));
+    return sorted[0] ?? docs[0];
+}
+async function resolveListContext(retrieval, targetBinding, query, retrievalSpec, outputModeOverride, defaultListLimit) {
+    const limit = retrievalSpec.limit ?? defaultListLimit;
+    if (!Number.isFinite(limit) || limit <= 0) {
+        throw new Error('list context limit is mandatory and must be positive');
+    }
+    const sort = sortSpecsToMongo(retrievalSpec.sort, DEFAULT_SCOPED_AT_SORT);
+    const docs = await readObjectTypeDocuments(retrieval, targetBinding, {
+        query,
+        limit,
+        sort,
+    });
+    const mode = outputModeOverride ?? retrievalSpec.outputMode ?? 'data';
+    return docs.map((doc) => formatOutputRecord(doc, mode));
+}
+async function resolveAggregateContext(retrieval, targetBinding, query, retrievalSpec) {
+    const docs = await readObjectTypeDocuments(retrieval, targetBinding, {
+        query,
+        limit: 5000,
+    });
+    const out = {};
+    for (const propertyPath of retrievalSpec.properties) {
+        const leaf = propertyPath.split('.').pop() ?? propertyPath;
+        const counts = {};
+        for (const doc of docs) {
+            const value = readPath(doc, propertyPath);
+            const key = normalizeAggregateKey(value);
+            counts[key] = (counts[key] ?? 0) + 1;
+        }
+        out[leaf] = counts;
+    }
+    return out;
+}
+function normalizeAggregateKey(value) {
+    if (value === null || value === undefined)
+        return 'null';
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return String(value);
+}
+function compareBySortSpec(a, b, sort) {
+    for (const [path, direction] of Object.entries(sort)) {
+        const av = readPath(a, path) ?? a[path];
+        const bv = readPath(b, path) ?? b[path];
+        if (av === bv)
+            continue;
+        if (av === undefined || av === null)
+            return direction;
+        if (bv === undefined || bv === null)
+            return -direction;
+        if (av < bv)
+            return -direction;
+        if (av > bv)
+            return direction;
+    }
+    return compareIds(readRecordId(a), readRecordId(b));
+}
+function compareIds(a, b) {
+    if (a === b)
+        return 0;
+    return a < b ? -1 : 1;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/service.d.ts

@@ -0,0 +1,43 @@
+import type { MemorixRetrievalClient } from '@x12i/memorix-retrieval';
+import { HippoxStore } from './store.js';
+import type { ContextLink, ContextLinkInput, ResolveContextInput, SimulationSummary } from './types.js';
+import { HippoxValidationError } from './validation.js';
+export type HippoxServiceOptions = {
+    retrieval: MemorixRetrievalClient;
+    processEnv?: NodeJS.ProcessEnv;
+    store?: HippoxStore;
+};
+export declare class HippoxService {
+    readonly retrieval: MemorixRetrievalClient;
+    readonly store: HippoxStore;
+    private readonly processEnv;
+    private constructor();
+    static create(options: HippoxServiceOptions): Promise<HippoxService>;
+    close(): Promise<void>;
+    listLinks(sourceObjectType: string): Promise<ContextLink[]>;
+    createDraftLink(input: ContextLinkInput): Promise<ContextLink>;
+    getLink(id: string): Promise<ContextLink | null>;
+    simulateLinkById(id: string): Promise<{
+        link: ContextLink;
+        simulation: SimulationSummary;
+    }>;
+    simulateInlineLink(input: ContextLinkInput): Promise<{
+        link: ContextLink;
+        simulation: SimulationSummary;
+    }>;
+    simulateAndPersist(id: string): Promise<{
+        link: ContextLink;
+        simulation: SimulationSummary;
+    }>;
+    approveLink(id: string): Promise<ContextLink>;
+    resolveContextInput(input: ResolveContextInput): Promise<import("./types.js").ResolveContextResult>;
+    resolveMixedContextInput(input: ResolveContextInput & {
+        legacyContextLinks?: import('@x12i/memorix-mongo').JobContextLink[];
+        sourceEntity?: string;
+    }): Promise<import("./types.js").ResolveContextResult & {
+        legacy?: Record<string, unknown>;
+    }>;
+    private simulateLinkDefinition;
+}
+export declare function isHippoxValidationError(err: unknown): err is HippoxValidationError;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAqB,MAAM,YAAY,CAAC;AAI5D,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAA4B,MAAM,iBAAiB,CAAC;AAElF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,sBAAsB,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,qBAAa,aAAa;IACxB,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAE/C,OAAO;WAMM,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAQpE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI3D,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAI9D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAIhD,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,UAAU,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAM3F,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,UAAU,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAqB1G,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,UAAU,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAU7F,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI7C,mBAAmB,CAAC,KAAK,EAAE,mBAAmB;IAS9C,wBAAwB,CAC5B,KAAK,EAAE,mBAAmB,GAAG;QAC3B,kBAAkB,CAAC,EAAE,OAAO,qBAAqB,EAAE,cAAc,EAAE,CAAC;QACpE,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;;;YAUW,sBAAsB;CAQrC;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,qBAAqB,CAElF"}

package/dist/service.js

@@ -0,0 +1,96 @@
+import { HippoxStore, createHippoxStore } from './store.js';
+import { simulateContextLink } from './simulate.js';
+import { resolveContext } from './resolve.js';
+import { resolveMixedContext } from './legacy-bridge.js';
+import { HippoxValidationError, validateContextLinkInput } from './validation.js';
+export class HippoxService {
+    retrieval;
+    store;
+    processEnv;
+    constructor(options) {
+        this.retrieval = options.retrieval;
+        this.store = options.store;
+        this.processEnv = options.processEnv ?? process.env;
+    }
+    static async create(options) {
+        const store = options.store ?? await createHippoxStore({
+            retrieval: options.retrieval,
+            processEnv: options.processEnv,
+        });
+        return new HippoxService({ ...options, store });
+    }
+    async close() {
+        await this.store.close();
+    }
+    async listLinks(sourceObjectType) {
+        return this.store.listBySourceObjectType(sourceObjectType);
+    }
+    async createDraftLink(input) {
+        return this.store.createDraft(validateContextLinkInput(input));
+    }
+    async getLink(id) {
+        return this.store.getById(id);
+    }
+    async simulateLinkById(id) {
+        const link = await this.store.getById(id);
+        if (!link)
+            throw new Error(`context link not found: ${id}`);
+        return this.simulateLinkDefinition(link);
+    }
+    async simulateInlineLink(input) {
+        const validated = validateContextLinkInput(input);
+        const now = new Date().toISOString();
+        const link = {
+            id: validated.id ?? 'inline',
+            sourceObjectType: validated.sourceObjectType,
+            targetObjectType: validated.targetObjectType,
+            alias: validated.alias,
+            direction: validated.direction,
+            sourceContentType: validated.sourceContentType,
+            targetContentType: validated.targetContentType,
+            join: validated.join,
+            fixedFilters: validated.fixedFilters,
+            retrieval: validated.retrieval,
+            status: 'draft',
+            createdAt: now,
+            updatedAt: now,
+        };
+        return this.simulateLinkDefinition(link);
+    }
+    async simulateAndPersist(id) {
+        const { link, simulation } = await this.simulateLinkById(id);
+        const updated = await this.store.saveSimulationResult(id, simulation, simulation.indexRecommendations);
+        return { link: updated, simulation };
+    }
+    async approveLink(id) {
+        return this.store.approve(id);
+    }
+    async resolveContextInput(input) {
+        return resolveContext({
+            retrieval: this.retrieval,
+            store: this.store,
+            input,
+            processEnv: this.processEnv,
+        });
+    }
+    async resolveMixedContextInput(input) {
+        return resolveMixedContext({
+            retrieval: this.retrieval,
+            store: this.store,
+            input,
+            processEnv: this.processEnv,
+        });
+    }
+    async simulateLinkDefinition(link) {
+        const simulation = await simulateContextLink({
+            retrieval: this.retrieval,
+            link,
+            processEnv: this.processEnv,
+        });
+        return { link, simulation };
+    }
+}
+export function isHippoxValidationError(err) {
+    return err instanceof HippoxValidationError;
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/simulate.d.ts

@@ -0,0 +1,11 @@
+import type { MemorixRetrievalClient } from '@x12i/memorix-retrieval';
+import type { ContextLink, SimulationSummary } from './types.js';
+export type SimulateContextLinkOptions = {
+    retrieval: MemorixRetrievalClient;
+    link: ContextLink;
+    processEnv?: NodeJS.ProcessEnv;
+    sampleLimit?: number;
+    examplesLimit?: number;
+};
+export declare function simulateContextLink(options: SimulateContextLinkOptions): Promise<SimulationSummary>;
+//# sourceMappingURL=simulate.d.ts.map

package/dist/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../src/simulate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAUtE,OAAO,KAAK,EACV,WAAW,EAIX,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,sBAAsB,CAAC;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAmJ5B"}