@x12i/memorix-hippox 1.0.0

package/dist/simulate.js

@@ -0,0 +1,211 @@
+import { loadHippoxConfig } from './config.js';
+import { buildTargetQueryFromLink } from './filters.js';
+import { countObjectTypeDocuments, readObjectTypeDocuments, resolveObjectTypeCollection, } from './collection-resolver.js';
+import { recommendIndexesForLink } from './index-recommendations.js';
+import { readPath, readRecordId } from './paths.js';
+export async function simulateContextLink(options) {
+    const config = loadHippoxConfig(options.processEnv);
+    const sampleLimit = options.sampleLimit ?? config.simulationLimit;
+    const examplesLimit = options.examplesLimit ?? config.simulationExamplesLimit;
+    const link = options.link;
+    const retrieval = options.retrieval;
+    const sourceBinding = await resolveObjectTypeCollection(retrieval, link.sourceObjectType, link.sourceContentType);
+    const targetBinding = await resolveObjectTypeCollection(retrieval, link.targetObjectType, link.targetContentType);
+    const sourceCount = await countObjectTypeDocuments(retrieval, sourceBinding);
+    const targetCount = await countObjectTypeDocuments(retrieval, targetBinding);
+    const driveFromSource = sourceCount <= targetCount;
+    const smallerCount = driveFromSource ? sourceCount : targetCount;
+    const exhaustive = sourceCount <= sampleLimit && targetCount <= sampleLimit;
+    const sampleSize = exhaustive ? smallerCount : Math.min(sampleLimit, smallerCount);
+    const sampledRecords = driveFromSource
+        ? await readObjectTypeDocuments(retrieval, sourceBinding, { limit: sampleSize })
+        : await readObjectTypeDocuments(retrieval, targetBinding, { limit: sampleSize });
+    let matchedSourceCount = 0;
+    let unmatchedSourceCount = 0;
+    let multipleMatchSourceCount = 0;
+    let queriedTargetCount = 0;
+    const propertyStats = initPropertyStats(link);
+    const examples = [];
+    const misses = [];
+    const warnings = [];
+    if (driveFromSource) {
+        for (const sourceRecord of sampledRecords) {
+            const sourceId = readRecordId(sourceRecord);
+            const query = buildTargetQueryFromLink(link, sourceRecord);
+            updatePropertyStats(propertyStats, link, sourceRecord, query !== null);
+            if (!query) {
+                unmatchedSourceCount += 1;
+                pushMiss(misses, examplesLimit, {
+                    sourceRecordId: sourceId,
+                    reason: 'missing join source field values',
+                    joinValues: joinValuesForRecord(link, sourceRecord),
+                });
+                continue;
+            }
+            const matches = await readObjectTypeDocuments(retrieval, targetBinding, {
+                query,
+                limit: 5,
+            });
+            queriedTargetCount += 1;
+            if (matches.length === 0) {
+                unmatchedSourceCount += 1;
+                pushMiss(misses, examplesLimit, {
+                    sourceRecordId: sourceId,
+                    reason: 'no target match',
+                    joinValues: joinValuesForRecord(link, sourceRecord),
+                });
+            }
+            else if (matches.length === 1) {
+                matchedSourceCount += 1;
+                pushExample(examples, examplesLimit, {
+                    sourceRecordId: sourceId,
+                    targetRecordIds: matches.map(readRecordId),
+                    joinValues: joinValuesForRecord(link, sourceRecord),
+                });
+            }
+            else {
+                multipleMatchSourceCount += 1;
+                matchedSourceCount += 1;
+                pushExample(examples, examplesLimit, {
+                    sourceRecordId: sourceId,
+                    targetRecordIds: matches.map(readRecordId),
+                    joinValues: joinValuesForRecord(link, sourceRecord),
+                });
+            }
+        }
+    }
+    else {
+        warnings.push({
+            code: 'target_driven_sampling',
+            message: 'Target collection is smaller; simulation sampled target records and checked reverse coverage heuristically.',
+            severity: 'info',
+        });
+        for (const targetRecord of sampledRecords) {
+            queriedTargetCount += 1;
+            const reverseMatches = await countReverseMatches(retrieval, sourceBinding, link, targetRecord);
+            if (reverseMatches === 0)
+                unmatchedSourceCount += 1;
+            else if (reverseMatches > 1)
+                multipleMatchSourceCount += 1;
+            else
+                matchedSourceCount += 1;
+        }
+    }
+    const evaluated = driveFromSource ? sampledRecords.length : sampledRecords.length;
+    const overallMatchQuality = evaluated > 0 ? matchedSourceCount / evaluated : 0;
+    const propertyQuality = finalizePropertyStats(propertyStats, evaluated);
+    if (multipleMatchSourceCount > 0 && evaluated > 0 && multipleMatchSourceCount / evaluated > 0.2) {
+        warnings.push({
+            code: 'high_duplicate_matches',
+            message: 'More than 20% of sampled sources match multiple target records.',
+            severity: 'warn',
+        });
+    }
+    if (overallMatchQuality < 0.5) {
+        warnings.push({
+            code: 'low_confidence',
+            message: 'Overall match quality is below 50%.',
+            severity: 'warn',
+        });
+    }
+    if (sourceCount > sampleLimit || targetCount > sampleLimit) {
+        warnings.push({
+            code: 'sampled_mode',
+            message: `Simulation used sampling with limit ${sampleLimit}.`,
+            severity: 'info',
+        });
+    }
+    const indexRecommendations = await recommendIndexesForLink(retrieval, link);
+    return {
+        mode: exhaustive ? 'exhaustive' : 'sampled',
+        sampleLimit,
+        sourceRecordCount: sourceCount,
+        targetRecordCount: targetCount,
+        sampledSourceCount: driveFromSource ? sampledRecords.length : 0,
+        queriedTargetCount,
+        matchedSourceCount,
+        unmatchedSourceCount,
+        multipleMatchSourceCount,
+        overallMatchQuality,
+        propertyQuality,
+        examples,
+        misses,
+        warnings,
+        indexRecommendations,
+        simulatedAt: new Date().toISOString(),
+    };
+}
+function initPropertyStats(link) {
+    const stats = new Map();
+    for (const join of link.join) {
+        stats.set(`${join.sourcePath}->${join.targetPath}`, { matched: 0, missing: 0 });
+    }
+    return stats;
+}
+function updatePropertyStats(stats, link, sourceRecord, allJoinValuesPresent) {
+    for (const join of link.join) {
+        const key = `${join.sourcePath}->${join.targetPath}`;
+        const row = stats.get(key);
+        const value = readPath(sourceRecord, join.sourcePath);
+        if (value === undefined || value === null)
+            row.missing += 1;
+        else if (allJoinValuesPresent)
+            row.matched += 1;
+    }
+}
+function finalizePropertyStats(stats, evaluated) {
+    const out = [];
+    for (const [key, row] of stats.entries()) {
+        const [sourcePath, targetPath] = key.split('->');
+        out.push({
+            sourcePath: sourcePath,
+            targetPath: targetPath,
+            matchedCount: row.matched,
+            missingSourceFieldCount: row.missing,
+            sampleCoverage: evaluated > 0 ? row.matched / evaluated : 0,
+        });
+    }
+    return out;
+}
+function joinValuesForRecord(link, sourceRecord) {
+    const out = {};
+    for (const join of link.join) {
+        out[join.sourcePath] = readPath(sourceRecord, join.sourcePath);
+    }
+    return out;
+}
+function pushExample(list, limit, item) {
+    if (list.length >= limit)
+        return;
+    list.push(item);
+}
+function pushMiss(list, limit, item) {
+    if (list.length >= limit)
+        return;
+    list.push(item);
+}
+async function countReverseMatches(retrieval, sourceBinding, link, targetRecord) {
+    const syntheticSource = { data: {} };
+    for (const join of link.join) {
+        const targetValue = readPath(targetRecord, join.targetPath);
+        const sourceRoot = join.sourcePath.startsWith('data.')
+            ? syntheticSource
+            : syntheticSource;
+        const segments = join.sourcePath.split('.');
+        let cursor = sourceRoot;
+        for (let i = 0; i < segments.length - 1; i += 1) {
+            const seg = segments[i];
+            const next = cursor[seg];
+            if (!next || typeof next !== 'object') {
+                cursor[seg] = {};
+            }
+            cursor = cursor[seg];
+        }
+        cursor[segments[segments.length - 1]] = targetValue;
+    }
+    const query = buildTargetQueryFromLink(link, syntheticSource);
+    if (!query)
+        return 0;
+    return countObjectTypeDocuments(retrieval, sourceBinding, query);
+}
+//# sourceMappingURL=simulate.js.map

package/dist/simulate.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,39 @@
+import type { Collection } from 'mongodb';
+import type { MemorixRetrievalClient } from '@x12i/memorix-retrieval';
+import type { ContextLink, ContextLinkInput, IndexRecommendation, SimulationSummary } from './types.js';
+type HippoxStoreOptions = {
+    retrieval: MemorixRetrievalClient;
+    processEnv?: NodeJS.ProcessEnv;
+};
+type StoredContextLinkDoc = ContextLink & {
+    _id: string;
+};
+export declare class HippoxStore {
+    private readonly retrieval;
+    private readonly processEnv;
+    private client;
+    private db;
+    private collection;
+    private approvedCache;
+    private approvedCacheLoadedAt;
+    private readonly cacheTtlMs;
+    constructor(options: HippoxStoreOptions);
+    private config;
+    connect(): Promise<Collection<StoredContextLinkDoc>>;
+    close(): Promise<void>;
+    private ensureIndexes;
+    private toLink;
+    createDraft(input: ContextLinkInput): Promise<ContextLink>;
+    getById(id: string): Promise<ContextLink | null>;
+    listBySourceObjectType(sourceObjectType: string): Promise<ContextLink[]>;
+    saveSimulationResult(id: string, summary: SimulationSummary, recommendations: IndexRecommendation[]): Promise<ContextLink>;
+    approve(id: string): Promise<ContextLink>;
+    getApprovedByIds(ids: string[]): Promise<ContextLink[]>;
+    recordUsage(ids: string[]): Promise<void>;
+    private invalidateApprovedCache;
+    getApprovedCached(id: string): Promise<ContextLink | null>;
+    private refreshApprovedCache;
+}
+export declare function createHippoxStore(options: HippoxStoreOptions): Promise<HippoxStore>;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,SAAS,CAAC;AAE3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAGpB,KAAK,kBAAkB,GAAG;IACxB,SAAS,EAAE,sBAAsB,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAChC,CAAC;AAEF,KAAK,oBAAoB,GAAG,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,UAAU,CAAiD;IACnE,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAEzB,OAAO,EAAE,kBAAkB;IAKvC,OAAO,CAAC,MAAM;IAIR,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAWpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAUd,aAAa;IAO3B,OAAO,CAAC,MAAM;IAKR,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAyB1D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAMhD,sBAAsB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAqBxE,oBAAoB,CACxB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,iBAAiB,EAC1B,eAAe,EAAE,mBAAmB,EAAE,GACrC,OAAO,CAAC,WAAW,CAAC;IAqBjB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAyBzC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAOvD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C,OAAO,CAAC,uBAAuB;IAKzB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;YAKlD,oBAAoB;CAYnC;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAIzF"}

package/dist/store.js

@@ -0,0 +1,180 @@
+import { randomUUID } from 'node:crypto';
+import { getMongoForRetrieval } from '@x12i/memorix-mongo';
+import { loadHippoxConfig } from './config.js';
+import { validateContextLinkInput } from './validation.js';
+export class HippoxStore {
+    retrieval;
+    processEnv;
+    client = null;
+    db = null;
+    collection = null;
+    approvedCache = new Map();
+    approvedCacheLoadedAt = 0;
+    cacheTtlMs = 30_000;
+    constructor(options) {
+        this.retrieval = options.retrieval;
+        this.processEnv = options.processEnv ?? process.env;
+    }
+    config() {
+        return loadHippoxConfig(this.processEnv);
+    }
+    async connect() {
+        if (this.collection)
+            return this.collection;
+        const lease = await getMongoForRetrieval(this.retrieval);
+        this.client = lease.client;
+        const { dbName, collectionName } = this.config();
+        this.db = this.client.db(dbName);
+        this.collection = this.db.collection(collectionName);
+        await this.ensureIndexes();
+        return this.collection;
+    }
+    async close() {
+        this.collection = null;
+        this.db = null;
+        this.approvedCache.clear();
+        if (this.client) {
+            await this.client.close();
+            this.client = null;
+        }
+    }
+    async ensureIndexes() {
+        const coll = await this.connect();
+        await coll.createIndex({ sourceObjectType: 1, status: 1, updatedAt: -1 }, { name: 'idx_source_status_updated' });
+        await coll.createIndex({ targetObjectType: 1, status: 1 }, { name: 'idx_target_status' });
+        await coll.createIndex({ status: 1, approvedAt: -1 }, { name: 'idx_status_approved' });
+    }
+    toLink(doc) {
+        const { _id, ...rest } = doc;
+        return { ...rest, id: rest.id || _id };
+    }
+    async createDraft(input) {
+        const validated = validateContextLinkInput(input);
+        const coll = await this.connect();
+        const now = new Date().toISOString();
+        const id = validated.id?.trim() || randomUUID();
+        const link = {
+            id,
+            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,
+            usageCount: 0,
+        };
+        await coll.insertOne({ ...link, _id: id });
+        return link;
+    }
+    async getById(id) {
+        const coll = await this.connect();
+        const doc = await coll.findOne({ _id: id });
+        return doc ? this.toLink(doc) : null;
+    }
+    async listBySourceObjectType(sourceObjectType) {
+        const coll = await this.connect();
+        const docs = await coll
+            .find({
+            sourceObjectType,
+            status: { $in: ['approved', 'draft', 'simulated'] },
+        })
+            .sort({ status: 1, approvedAt: -1, updatedAt: -1 })
+            .toArray();
+        const statusOrder = (status) => {
+            if (status === 'approved')
+                return 0;
+            if (status === 'simulated')
+                return 1;
+            return 2;
+        };
+        return docs
+            .map((doc) => this.toLink(doc))
+            .sort((a, b) => statusOrder(a.status) - statusOrder(b.status));
+    }
+    async saveSimulationResult(id, summary, recommendations) {
+        const coll = await this.connect();
+        const now = new Date().toISOString();
+        const result = await coll.findOneAndUpdate({ _id: id }, {
+            $set: {
+                status: 'simulated',
+                lastSimulation: summary,
+                confidence: summary.overallMatchQuality,
+                indexRecommendations: recommendations,
+                updatedAt: now,
+            },
+        }, { returnDocument: 'after' });
+        if (!result)
+            throw new Error(`context link not found: ${id}`);
+        this.invalidateApprovedCache();
+        return this.toLink(result);
+    }
+    async approve(id) {
+        const coll = await this.connect();
+        const existing = await coll.findOne({ _id: id });
+        if (!existing)
+            throw new Error(`context link not found: ${id}`);
+        if (!existing.lastSimulation) {
+            throw new Error('link must be simulated before approval');
+        }
+        const now = new Date().toISOString();
+        const result = await coll.findOneAndUpdate({ _id: id }, {
+            $set: {
+                status: 'approved',
+                approvedAt: now,
+                updatedAt: now,
+                usageCount: existing.usageCount ?? 0,
+            },
+        }, { returnDocument: 'after' });
+        if (!result)
+            throw new Error(`context link not found: ${id}`);
+        this.invalidateApprovedCache();
+        return this.toLink(result);
+    }
+    async getApprovedByIds(ids) {
+        if (ids.length === 0)
+            return [];
+        const coll = await this.connect();
+        const docs = await coll.find({ _id: { $in: ids }, status: 'approved' }).toArray();
+        return docs.map((doc) => this.toLink(doc));
+    }
+    async recordUsage(ids) {
+        if (ids.length === 0)
+            return;
+        const coll = await this.connect();
+        const now = new Date().toISOString();
+        await coll.updateMany({ _id: { $in: ids }, status: 'approved' }, { $inc: { usageCount: 1 }, $set: { lastUsedAt: now, updatedAt: now } });
+    }
+    invalidateApprovedCache() {
+        this.approvedCache.clear();
+        this.approvedCacheLoadedAt = 0;
+    }
+    async getApprovedCached(id) {
+        await this.refreshApprovedCache();
+        return this.approvedCache.get(id) ?? null;
+    }
+    async refreshApprovedCache() {
+        const now = Date.now();
+        if (now - this.approvedCacheLoadedAt < this.cacheTtlMs && this.approvedCache.size > 0)
+            return;
+        const coll = await this.connect();
+        const docs = await coll.find({ status: 'approved' }).toArray();
+        this.approvedCache.clear();
+        for (const doc of docs) {
+            const link = this.toLink(doc);
+            this.approvedCache.set(link.id, link);
+        }
+        this.approvedCacheLoadedAt = now;
+    }
+}
+export async function createHippoxStore(options) {
+    const store = new HippoxStore(options);
+    await store.connect();
+    return store;
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,135 @@
+export type LinkDirection = 'downstream' | 'upstream';
+export type LinkStatus = 'draft' | 'simulated' | 'approved' | 'disabled';
+export type JoinOperator = 'eq' | 'ne' | 'in' | 'nin';
+export type FilterOperator = 'eq' | 'ne' | 'in' | 'nin' | 'exists' | 'gt' | 'gte' | 'lt' | 'lte';
+export type OutputMode = 'data' | 'record' | 'dataWithRecordId';
+export type RetrievalType = 'record' | 'list' | 'aggregate';
+export type JoinMapping = {
+    sourcePath: string;
+    targetPath: string;
+    operator?: JoinOperator;
+};
+export type FixedFilter = {
+    targetPath: string;
+    operator: FilterOperator;
+    value?: unknown;
+};
+export type SortSpec = {
+    path: string;
+    direction: 'asc' | 'desc';
+};
+export type RecordRetrieval = {
+    type: 'record';
+    dateField?: string;
+    sort?: SortSpec[];
+    condition?: string;
+    outputMode?: OutputMode;
+};
+export type ListRetrieval = {
+    type: 'list';
+    sort?: SortSpec[];
+    limit?: number;
+    outputMode?: OutputMode;
+};
+export type AggregateRetrieval = {
+    type: 'aggregate';
+    properties: string[];
+};
+export type ContextLinkRetrieval = RecordRetrieval | ListRetrieval | AggregateRetrieval;
+export type ContextLink = {
+    id: string;
+    sourceObjectType: string;
+    targetObjectType: string;
+    alias?: string;
+    direction: LinkDirection;
+    sourceContentType?: string;
+    targetContentType?: string;
+    join: JoinMapping[];
+    fixedFilters?: FixedFilter[];
+    retrieval: ContextLinkRetrieval;
+    status: LinkStatus;
+    createdAt: string;
+    updatedAt: string;
+    approvedAt?: string;
+    lastSimulation?: SimulationSummary;
+    confidence?: number;
+    indexRecommendations?: IndexRecommendation[];
+    usageCount?: number;
+    lastUsedAt?: string;
+};
+export type ContextLinkInput = Omit<ContextLink, 'id' | 'status' | 'createdAt' | 'updatedAt' | 'approvedAt' | 'lastSimulation' | 'confidence' | 'indexRecommendations' | 'usageCount' | 'lastUsedAt'> & {
+    id?: string;
+    status?: LinkStatus;
+};
+export type IndexRecommendation = {
+    field: string;
+    reason: string;
+    suggestedIndex?: Record<string, 1 | -1>;
+};
+export type SimulationWarning = {
+    code: string;
+    message: string;
+    severity: 'info' | 'warn' | 'error';
+};
+export type PropertyMatchQuality = {
+    sourcePath: string;
+    targetPath: string;
+    matchedCount: number;
+    missingSourceFieldCount: number;
+    sampleCoverage: number;
+};
+export type SimulationExampleMatch = {
+    sourceRecordId: string;
+    targetRecordIds: string[];
+    joinValues: Record<string, unknown>;
+};
+export type SimulationExampleMiss = {
+    sourceRecordId: string;
+    reason: string;
+    joinValues?: Record<string, unknown>;
+};
+export type SimulationSummary = {
+    mode: 'exhaustive' | 'sampled';
+    sampleLimit: number;
+    sourceRecordCount: number;
+    targetRecordCount: number;
+    sampledSourceCount: number;
+    queriedTargetCount: number;
+    matchedSourceCount: number;
+    unmatchedSourceCount: number;
+    multipleMatchSourceCount: number;
+    overallMatchQuality: number;
+    propertyQuality: PropertyMatchQuality[];
+    examples: SimulationExampleMatch[];
+    misses: SimulationExampleMiss[];
+    warnings: SimulationWarning[];
+    indexRecommendations: IndexRecommendation[];
+    simulatedAt: string;
+};
+export type ResolveContextInput = {
+    sourceRecordId?: string;
+    sourceRecord?: Record<string, unknown>;
+    sourceObjectType?: string;
+    linkIds?: string[];
+    links?: ContextLink[];
+    outputMode?: OutputMode;
+};
+export type ResolveContextResult = {
+    jobMemory: {
+        context: Record<string, unknown>;
+    };
+};
+export type HippoxConfig = {
+    dbName: string;
+    collectionName: string;
+    simulationLimit: number;
+    simulationExamplesLimit: number;
+    contextListLimit: number;
+};
+export type ObjectTypeCollectionBinding = {
+    objectType: string;
+    contentType: string;
+    collectionName: string;
+    target: 'entity' | 'event' | 'knowledge';
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/validation.d.ts

@@ -0,0 +1,18 @@
+import type { ContextLinkInput, ContextLinkRetrieval } from './types.js';
+export declare class HippoxValidationError extends Error {
+    readonly statusCode = 400;
+    constructor(message: string);
+}
+export declare function validateContextLinkInput(input: ContextLinkInput): ContextLinkInput;
+export declare function defaultRecordRetrieval(): ContextLinkRetrieval;
+export declare function defaultListRetrieval(limit?: number): ContextLinkRetrieval;
+export declare function contextKeyForLink(link: {
+    targetObjectType: string;
+    alias?: string;
+}): string;
+export declare function detectContextKeyCollisions(links: Array<{
+    targetObjectType: string;
+    alias?: string;
+    id?: string;
+}>): string | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAQzE,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,UAAU,OAAO;gBACd,OAAO,EAAE,MAAM;CAI5B;AAwCD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAoClF;AAED,wBAAgB,sBAAsB,IAAI,oBAAoB,CAE7D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAEzE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE5F;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,CAAC;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACtE,MAAM,GAAG,IAAI,CAWf"}