@exellix/exellix-runtime 3.5.1

package/dist/execution-matrix/memorix-runtime-tier.js

@@ -0,0 +1,185 @@
+/**
+ * Memorix data tier for execution-matrix hosts (replaces `@x12i/xmemory-store` + `@x12i/xmemory-scoper`).
+ *
+ * Wires `@x12i/memorix-retrieval` stack from env and exposes a compatibility surface for
+ * {@link ./xmemory-op-tier.ts} (`env`, `mongoClient`, `opStore` / `corpusStore` collection reads).
+ */
+import { applyMemorixEnvBridgeToProcess, countMemorixCollection, createMemorixRetrievalStackFromEnv, readMemorixCollection, resolveMemorixDbName, } from '@x12i/memorix-retrieval';
+export const FIND_MANY_DEFAULT_LIMIT_WITH_SKIP = 200;
+export const FIND_MANY_MAX_SKIP = 100_000;
+export const FIND_MANY_MAX_WINDOW = 10_000;
+export const DEFAULT_SCOPED_DATA_COLLECTION = 'x-scoped-data';
+export const DEFAULT_SNAPSHOTS_COLLECTION = 'x-snapshots';
+export const COLLECTION_DEFAULTS = {
+    scopedDataCollection: DEFAULT_SCOPED_DATA_COLLECTION,
+    snapshotsCollection: DEFAULT_SNAPSHOTS_COLLECTION,
+    viewsCollection: 'scoped_views',
+    thingsCollection: 'things',
+};
+export function resolveMemorixRuntimeTierEnv(processEnv = process.env) {
+    applyMemorixEnvBridgeToProcess(processEnv);
+    const entitiesDb = resolveMemorixDbName('entity', processEnv);
+    const opDb = processEnv.XMEMORY_OP_DB?.trim() ||
+        processEnv.MEMORIX_ENTITIES_DB?.trim() ||
+        entitiesDb;
+    const thingsDb = processEnv.XMEMORY_THINGS_DB?.trim() ||
+        processEnv.MEMORIX_ENTITIES_DB?.trim() ||
+        entitiesDb;
+    const mapsDb = processEnv.XMEMORY_MAPS_DB?.trim() || processEnv.MEMORIX_EVENTS_DB?.trim() || entitiesDb;
+    const metaDb = processEnv.XMEMORY_META_DB?.trim() || mapsDb;
+    return {
+        entitiesDb,
+        opDb,
+        thingsDb,
+        mapsDb,
+        metaDb,
+        scopedDataCollection: processEnv.SCOPED_DATA_COLLECTION?.trim() || COLLECTION_DEFAULTS.scopedDataCollection,
+        snapshotsCollection: processEnv.SNAPSHOTS_COLLECTION?.trim() || COLLECTION_DEFAULTS.snapshotsCollection,
+        viewsCollection: processEnv.VIEWS_COLLECTION?.trim() || COLLECTION_DEFAULTS.viewsCollection,
+        thingsCollection: processEnv.THINGS_COLLECTION?.trim() || COLLECTION_DEFAULTS.thingsCollection,
+    };
+}
+/** @deprecated Use {@link resolveMemorixRuntimeTierEnv}. */
+export function resolveXmemoryStoreEnv(processEnv) {
+    const env = process.env;
+    const merged = processEnv ? { ...env, ...processEnv } : env;
+    const tierEnv = resolveMemorixRuntimeTierEnv(merged);
+    const mongoUri = merged.MONGO_URI?.trim();
+    if (!mongoUri) {
+        throw new Error('resolveXmemoryStoreEnv: MONGO_URI is required');
+    }
+    return {
+        mongoUri,
+        opDb: tierEnv.opDb,
+        thingsDb: tierEnv.thingsDb,
+        mapsDb: tierEnv.mapsDb,
+        metaDb: tierEnv.metaDb,
+    };
+}
+function createMongoClientShim(client) {
+    const getMongo = async () => {
+        if (!client.getMongo) {
+            throw new Error('MemorixRuntimeTier: client.getMongo is not available — use createMemorixRetrievalStackFromEnv');
+        }
+        return client.getMongo();
+    };
+    return {
+        findMany: async ({ database, collection, filter, projection, limit, skip }) => {
+            const mongo = await getMongo();
+            return readMemorixCollection(mongo, {
+                db: database,
+                collection,
+                query: filter,
+                project: projection ? Object.keys(projection).filter((k) => projection[k]) : undefined,
+                limit,
+                skip,
+            });
+        },
+        countMany: async ({ database, collection, filter }) => {
+            const mongo = await getMongo();
+            return countMemorixCollection(mongo, { db: database, collection, query: filter });
+        },
+    };
+}
+function createStoreLike(tier, database) {
+    return {
+        collection: (name) => ({
+            readMany: async (filter, opts) => {
+                return tier.mongoClient.findMany({
+                    database,
+                    collection: name,
+                    filter,
+                    limit: opts?.limit,
+                    skip: undefined,
+                });
+            },
+            countMatching: async (filter, _opts) => {
+                const cm = tier.mongoClient.countMany;
+                if (!cm) {
+                    throw new Error(`MemorixRuntimeTier: countMany unavailable for ${database}.${name}`);
+                }
+                return cm({ database, collection: name, filter });
+            },
+        }),
+    };
+}
+async function attachRuntimeTierFields(client, processEnv, options) {
+    const env = resolveMemorixRuntimeTierEnv(processEnv);
+    const mongoClient = options?.fallbackMongoClient ?? createMongoClientShim(client);
+    const base = client;
+    Object.defineProperty(base, 'env', { value: env, enumerable: true });
+    Object.defineProperty(base, 'mongoClient', { value: mongoClient, enumerable: true });
+    Object.defineProperty(base, 'opStore', { value: createStoreLike(base, env.opDb), enumerable: true });
+    Object.defineProperty(base, 'corpusStore', { value: createStoreLike(base, env.thingsDb), enumerable: true });
+    Object.defineProperty(base, 'mapsStore', { value: createStoreLike(base, env.mapsDb), enumerable: true });
+    Object.defineProperty(base, 'metaStore', { value: createStoreLike(base, env.metaDb), enumerable: true });
+    Object.defineProperty(base, 'storeBindings', { value: {}, enumerable: true });
+    base.init = async () => base;
+    base.close = async () => {
+        await client.close?.();
+    };
+    base.runMongoAggregate = async ({ database, collection, pipeline }) => {
+        if (!client.getMongo) {
+            throw new Error('MemorixRuntimeTier.runMongoAggregate: getMongo unavailable');
+        }
+        const mongo = await client.getMongo();
+        return mongo.db(database).collection(collection).aggregate(pipeline).toArray();
+    };
+    return base;
+}
+/**
+ * Create a Memorix retrieval client + matrix-compat tier surface from env (`MONGO_URI`, Catalox, `MEMORIX_*_DB`).
+ */
+export async function createMemorixRuntimeTier(options) {
+    const processEnv = { ...process.env, ...(options?.processEnv ?? {}) };
+    if (options?.mongoUri) {
+        processEnv.MONGO_URI = options.mongoUri;
+    }
+    applyMemorixEnvBridgeToProcess(processEnv);
+    const stack = await createMemorixRetrievalStackFromEnv({ processEnv });
+    return attachRuntimeTierFields(stack.client, processEnv, options);
+}
+/**
+ * Legacy factory: returns a tier handle; call **`await tier.init()`** before use (same as xmemory-store).
+ */
+export function createXmemoryDataTier(options) {
+    let ready;
+    let initPromise;
+    const ensureInit = () => {
+        if (ready)
+            return Promise.resolve(ready);
+        if (!initPromise) {
+            initPromise = createMemorixRuntimeTier(options).then((t) => {
+                ready = t;
+                return t;
+            });
+        }
+        return initPromise;
+    };
+    const proxy = new Proxy({}, {
+        get(_target, prop, receiver) {
+            if (prop === 'init') {
+                return async () => ensureInit();
+            }
+            if (prop === 'then') {
+                return undefined;
+            }
+            const tier = ready;
+            if (!tier) {
+                if (prop === 'env' ||
+                    prop === 'mongoClient' ||
+                    prop === 'opStore' ||
+                    prop === 'corpusStore' ||
+                    prop === 'mapsStore' ||
+                    prop === 'metaStore') {
+                    throw new Error('createXmemoryDataTier: call await tier.init() before accessing tier fields (Memorix stack)');
+                }
+                return Reflect.get(_target, prop, receiver);
+            }
+            const value = tier[prop];
+            return typeof value === 'function' ? value.bind(tier) : value;
+        },
+    });
+    return proxy;
+}
+//# sourceMappingURL=memorix-runtime-tier.js.map

package/dist/execution-matrix/memorix-runtime-tier.js.map

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

package/dist/execution-matrix/memorix-tier-statistics.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Namespace-scoped entity-type statistics shaped like legacy `getXmemoryTierStatistics`
+ * (backed by `@x12i/memorix-retrieval` scoped workspace APIs).
+ */
+import { type MemorixRetrievalClient } from '@x12i/memorix-retrieval';
+import type { MemorixRuntimeTier } from './memorix-runtime-tier.js';
+export type TierCatalogEntityType = {
+    typeKey: string;
+    docCount: number;
+};
+export type TierSurfaceStatisticsSection = {
+    matchedDocTotal: number;
+    entityTypesTotal: number;
+    entityTypesSkip: number;
+    entityTypesLimit: number;
+    entityTypesHasMore: boolean;
+    entityTypes: TierCatalogEntityType[];
+};
+export type MemorixTierStatistics = {
+    generatedAt: string;
+    presetEffectiveAt: string;
+    ttlMsUsed: number;
+    appliedScope: {
+        namespace: string;
+    };
+    entityTypesSkip: number;
+    entityTypesLimit: number;
+    fromCache: boolean;
+    things: TierSurfaceStatisticsSection;
+    scopedViews: TierSurfaceStatisticsSection;
+    scopedData: TierSurfaceStatisticsSection;
+    snapshots: TierSurfaceStatisticsSection;
+};
+export type GetMemorixTierStatisticsOptions = {
+    namespace: string;
+    namespaceFieldPaths?: readonly string[];
+    entityTypesLimit?: number;
+    entityTypesSkip?: number;
+    groupByPaths?: {
+        scoped_data?: readonly string[];
+    };
+    surfaces?: Array<'things' | 'scoped_views' | 'scoped_data' | 'snapshots'>;
+    force?: boolean;
+    signal?: AbortSignal;
+};
+/**
+ * Legacy-compatible statistics for matrix entity facet / Catalox inventory.
+ */
+export declare function getMemorixTierStatistics(tier: MemorixRuntimeTier | MemorixRetrievalClient, options: GetMemorixTierStatisticsOptions): Promise<MemorixTierStatistics>;
+/** @deprecated Use {@link getMemorixTierStatistics}. */
+export declare const getXmemoryTierStatistics: typeof getMemorixTierStatistics;
+/** @deprecated Use {@link MemorixTierStatistics}. */
+export type XmemoryTierStatistics = MemorixTierStatistics;
+/** @deprecated Use {@link GetMemorixTierStatisticsOptions}. */
+export type GetXmemoryTierStatisticsOptions = GetMemorixTierStatisticsOptions;
+export type TierFetchScope = {
+    namespace: string;
+    entityTypeKey?: string;
+    extraMatch?: Record<string, unknown>;
+};
+export type TierFilterSurface = 'things' | 'scoped_views' | 'scoped_data' | 'snapshots';
+export declare function buildTierFetchMatch(scope: TierFetchScope, surface: TierFilterSurface): Record<string, unknown>;
+export declare function countScopedDataDocuments(tier: MemorixRuntimeTier | MemorixRetrievalClient, scope: TierFetchScope | {
+    namespace: string;
+    entityTypeKey?: string;
+    extraMatch?: Record<string, unknown>;
+}, _opts?: Record<string, unknown>): Promise<number>;
+export declare const TIER_STATS_MISSING_TYPE: "__missing__";
+export declare const DEFAULT_ENTITY_TYPE_PATHS: {
+    readonly scoped_data: readonly ["$entityType", "$entity_type"];
+};
+export declare const DEFAULT_ENTITY_TYPES_LIMIT = 200;
+export declare const DEFAULT_ENTITY_TYPES_SKIP = 0;
+export declare const ENTITY_TYPES_LIMIT_MAX = 500;
+export declare const DEFAULT_TIER_FILTER_CATALOG_TTL_MS = 60000;
+export declare const DEFAULT_TIER_STATISTICS_TTL_MS = 60000;
+export type TierCatalogFacet = Record<string, unknown>;
+export type TierFilterCatalog = Record<string, unknown>;
+export type TierObservedField = Record<string, unknown>;
+export declare const ENV_KEYS: {
+    readonly MONGO_URI: "MONGO_URI";
+    readonly MEMORIX_ENTITIES_DB: "MEMORIX_ENTITIES_DB";
+    readonly MEMORIX_EVENTS_DB: "MEMORIX_EVENTS_DB";
+};
+export declare const TIER_DATE_PRESET_IDS: readonly [];
+export declare const TIER_DATE_PRESET_METAS: readonly [];
+export declare const TIER_FACET_DIMENSIONS: readonly [];
+export declare const TIER_OBSERVED_FIELD_PATHS: readonly [];
+export declare function buildDatePresetMatches(): Record<string, unknown>[];
+export declare function buildEntityTypeStatisticsFacetPipeline(): Record<string, unknown>[];
+export declare function getTierFilterCatalog(): TierFilterCatalog;
+export declare function clearTierFetchCaches(): void;
+export declare function clearTierFilterCatalogCache(): void;
+export declare function clearTierStatisticsCache(): void;
+export declare function parseEntityTypeFacetRow(row: unknown): TierCatalogEntityType | undefined;
+export declare function resolveSurfaceDbCollection(): string;
+export declare function stableScopeKey(namespace: string): string;
+export declare function typeBucketExpr(): Record<string, unknown>;
+export declare function withEnrichmentFallback<T>(value: T): T;
+export declare function createScoperMongoClient(): never;
+export declare function getScoperStoreBindings(): never;
+export declare function pickEntityContentTypeCount(client: MemorixRetrievalClient, entityName: string, contentType: string): Promise<number>;
+//# sourceMappingURL=memorix-tier-statistics.d.ts.map

package/dist/execution-matrix/memorix-tier-statistics.d.ts.map

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

package/dist/execution-matrix/memorix-tier-statistics.js

@@ -0,0 +1,164 @@
+/**
+ * Namespace-scoped entity-type statistics shaped like legacy `getXmemoryTierStatistics`
+ * (backed by `@x12i/memorix-retrieval` scoped workspace APIs).
+ */
+import { countMemorixEntityContentTypeDocuments, countScopedWorkspaceDocuments, listScopedWorkspaceEntityTypes, } from '@x12i/memorix-retrieval';
+import { buildXMemorixSnapshotEntityTypeFilter, buildXScopedDataEntityTypeFilter, buildXScopedViewEntityTypeFilter, buildXThingEntityTypeFilter, } from './xmemory-op-tier.js';
+const EMPTY_SECTION = (overrides) => ({
+    matchedDocTotal: 0,
+    entityTypesTotal: 0,
+    entityTypesSkip: 0,
+    entityTypesLimit: 0,
+    entityTypesHasMore: false,
+    entityTypes: [],
+    ...overrides,
+});
+function sliceEntityTypes(types, skip, limit) {
+    const s = Math.max(0, skip ?? 0);
+    const lim = limit ?? types.length;
+    const page = types.slice(s, s + lim);
+    return { page, hasMore: s + page.length < types.length };
+}
+/**
+ * Legacy-compatible statistics for matrix entity facet / Catalox inventory.
+ */
+export async function getMemorixTierStatistics(tier, options) {
+    const client = tier;
+    const now = new Date().toISOString();
+    const skip = options.entityTypesSkip ?? DEFAULT_ENTITY_TYPES_SKIP;
+    const limit = options.entityTypesLimit ?? DEFAULT_ENTITY_TYPES_LIMIT;
+    const workspace = await listScopedWorkspaceEntityTypes(client, {
+        namespace: options.namespace,
+        namespaceFieldPaths: options.namespaceFieldPaths,
+    });
+    const allTypes = workspace.entityTypes.map((e) => ({ typeKey: e.typeKey, docCount: e.docCount }));
+    const { page, hasMore } = sliceEntityTypes(allTypes, skip, limit);
+    let scopedDataTotal = 0;
+    try {
+        scopedDataTotal = await countScopedWorkspaceDocuments(client, {
+            namespace: options.namespace,
+            namespaceFieldPaths: options.namespaceFieldPaths,
+        });
+    }
+    catch {
+        scopedDataTotal = allTypes.reduce((n, e) => n + e.docCount, 0);
+    }
+    const scopedData = {
+        matchedDocTotal: scopedDataTotal,
+        entityTypesTotal: allTypes.length,
+        entityTypesSkip: skip,
+        entityTypesLimit: limit,
+        entityTypesHasMore: hasMore,
+        entityTypes: page,
+    };
+    return {
+        generatedAt: now,
+        presetEffectiveAt: now,
+        ttlMsUsed: DEFAULT_TIER_STATISTICS_TTL_MS,
+        appliedScope: { namespace: options.namespace },
+        entityTypesSkip: skip,
+        entityTypesLimit: limit,
+        fromCache: false,
+        things: EMPTY_SECTION(),
+        scopedViews: EMPTY_SECTION(),
+        scopedData,
+        snapshots: EMPTY_SECTION(),
+    };
+}
+/** @deprecated Use {@link getMemorixTierStatistics}. */
+export const getXmemoryTierStatistics = getMemorixTierStatistics;
+export function buildTierFetchMatch(scope, surface) {
+    const key = scope.entityTypeKey;
+    if (!key)
+        return scope.extraMatch ?? {};
+    switch (surface) {
+        case 'things':
+            return { $and: [buildXThingEntityTypeFilter(key), ...(scope.extraMatch ? [scope.extraMatch] : [])] };
+        case 'scoped_views':
+            return { $and: [buildXScopedViewEntityTypeFilter(key), ...(scope.extraMatch ? [scope.extraMatch] : [])] };
+        case 'scoped_data':
+            return { $and: [buildXScopedDataEntityTypeFilter(key), ...(scope.extraMatch ? [scope.extraMatch] : [])] };
+        case 'snapshots':
+            return { $and: [buildXMemorixSnapshotEntityTypeFilter(key), ...(scope.extraMatch ? [scope.extraMatch] : [])] };
+        default:
+            return scope.extraMatch ?? {};
+    }
+}
+export async function countScopedDataDocuments(tier, scope, _opts) {
+    const client = tier;
+    const namespace = 'namespace' in scope ? scope.namespace : '';
+    const entityTypeKey = 'entityTypeKey' in scope ? scope.entityTypeKey : undefined;
+    if (entityTypeKey && 'extraMatch' in scope && scope.extraMatch) {
+        const tierHandle = tier;
+        if (tierHandle.env?.scopedDataCollection && tierHandle.mongoClient?.countMany) {
+            return tierHandle.mongoClient.countMany({
+                database: tierHandle.env.opDb,
+                collection: tierHandle.env.scopedDataCollection,
+                filter: { $and: [buildXScopedDataEntityTypeFilter(entityTypeKey), scope.extraMatch] },
+            });
+        }
+    }
+    return countScopedWorkspaceDocuments(client, { namespace });
+}
+export const TIER_STATS_MISSING_TYPE = '__missing__';
+export const DEFAULT_ENTITY_TYPE_PATHS = {
+    scoped_data: ['$entityType', '$entity_type'],
+};
+export const DEFAULT_ENTITY_TYPES_LIMIT = 200;
+export const DEFAULT_ENTITY_TYPES_SKIP = 0;
+export const ENTITY_TYPES_LIMIT_MAX = 500;
+export const DEFAULT_TIER_FILTER_CATALOG_TTL_MS = 60_000;
+export const DEFAULT_TIER_STATISTICS_TTL_MS = 60_000;
+export const ENV_KEYS = {
+    MONGO_URI: 'MONGO_URI',
+    MEMORIX_ENTITIES_DB: 'MEMORIX_ENTITIES_DB',
+    MEMORIX_EVENTS_DB: 'MEMORIX_EVENTS_DB',
+};
+export const TIER_DATE_PRESET_IDS = [];
+export const TIER_DATE_PRESET_METAS = [];
+export const TIER_FACET_DIMENSIONS = [];
+export const TIER_OBSERVED_FIELD_PATHS = [];
+export function buildDatePresetMatches() {
+    return [];
+}
+export function buildEntityTypeStatisticsFacetPipeline() {
+    return [];
+}
+export function getTierFilterCatalog() {
+    return {};
+}
+export function clearTierFetchCaches() { }
+export function clearTierFilterCatalogCache() { }
+export function clearTierStatisticsCache() { }
+export function parseEntityTypeFacetRow(row) {
+    if (!row || typeof row !== 'object')
+        return undefined;
+    const r = row;
+    const typeKey = typeof r.typeKey === 'string' ? r.typeKey : typeof r._id === 'string' ? r._id : undefined;
+    const docCount = typeof r.docCount === 'number' ? r.docCount : typeof r.count === 'number' ? r.count : 0;
+    if (!typeKey)
+        return undefined;
+    return { typeKey, docCount };
+}
+export function resolveSurfaceDbCollection() {
+    return '';
+}
+export function stableScopeKey(namespace) {
+    return namespace;
+}
+export function typeBucketExpr() {
+    return {};
+}
+export function withEnrichmentFallback(value) {
+    return value;
+}
+export function createScoperMongoClient() {
+    throw new Error('createScoperMongoClient: removed with xmemory-scoper — use createMemorixRuntimeTier / fetchMemorixItem');
+}
+export function getScoperStoreBindings() {
+    throw new Error('getScoperStoreBindings: removed with xmemory-scoper — use createMemorixRetrievalStackFromEnv');
+}
+export async function pickEntityContentTypeCount(client, entityName, contentType) {
+    return countMemorixEntityContentTypeDocuments(client, { entityName, contentType });
+}
+//# sourceMappingURL=memorix-tier-statistics.js.map

package/dist/execution-matrix/memorix-tier-statistics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-tier-statistics.js","sourceRoot":"","sources":["../../src/execution-matrix/memorix-tier-statistics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,sCAAsC,EACtC,6BAA6B,EAC7B,8BAA8B,GAE/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,qCAAqC,EACrC,gCAAgC,EAChC,gCAAgC,EAChC,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AA4C9B,MAAM,aAAa,GAAG,CAAC,SAAiD,EAAgC,EAAE,CAAC,CAAC;IAC1G,eAAe,EAAE,CAAC;IAClB,gBAAgB,EAAE,CAAC;IACnB,eAAe,EAAE,CAAC;IAClB,gBAAgB,EAAE,CAAC;IACnB,kBAAkB,EAAE,KAAK;IACzB,WAAW,EAAE,EAAE;IACf,GAAG,SAAS;CACb,CAAC,CAAC;AAEH,SAAS,gBAAgB,CACvB,KAA8B,EAC9B,IAAa,EACb,KAAc;IAEd,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;IACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAAiD,EACjD,OAAwC;IAExC,MAAM,MAAM,GAAG,IAA8B,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,eAAe,IAAI,yBAAyB,CAAC;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IAErE,MAAM,SAAS,GAAG,MAAM,8BAA8B,CAAC,MAAM,EAAE;QAC7D,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;KACjD,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAClG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAElE,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC;QACH,eAAe,GAAG,MAAM,6BAA6B,CAAC,MAAM,EAAE;YAC5D,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;SACjD,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,UAAU,GAAiC;QAC/C,eAAe,EAAE,eAAe;QAChC,gBAAgB,EAAE,QAAQ,CAAC,MAAM;QACjC,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,KAAK;QACvB,kBAAkB,EAAE,OAAO;QAC3B,WAAW,EAAE,IAAI;KAClB,CAAC;IAEF,OAAO;QACL,WAAW,EAAE,GAAG;QAChB,iBAAiB,EAAE,GAAG;QACtB,SAAS,EAAE,8BAA8B;QACzC,YAAY,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;QAC9C,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,KAAK;QACvB,SAAS,EAAE,KAAK;QAChB,MAAM,EAAE,aAAa,EAAE;QACvB,WAAW,EAAE,aAAa,EAAE;QAC5B,UAAU;QACV,SAAS,EAAE,aAAa,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAwB,CAAC;AAgBjE,MAAM,UAAU,mBAAmB,CACjC,KAAqB,EACrB,OAA0B;IAE1B,MAAM,GAAG,GAAG,KAAK,CAAC,aAAa,CAAC;IAChC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;IACxC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,CAAC,2BAA2B,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACvG,KAAK,cAAc;YACjB,OAAO,EAAE,IAAI,EAAE,CAAC,gCAAgC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5G,KAAK,aAAa;YAChB,OAAO,EAAE,IAAI,EAAE,CAAC,gCAAgC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5G,KAAK,WAAW;YACd,OAAO,EAAE,IAAI,EAAE,CAAC,qCAAqC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACjH;YACE,OAAO,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;IAClC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAAiD,EACjD,KAA2G,EAC3G,KAA+B;IAE/B,MAAM,MAAM,GAAG,IAA8B,CAAC;IAC9C,MAAM,SAAS,GAAG,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,MAAM,aAAa,GAAG,eAAe,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,IAAI,aAAa,IAAI,YAAY,IAAI,KAAK,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QAC/D,MAAM,UAAU,GAAG,IAA0B,CAAC;QAC9C,IAAI,UAAU,CAAC,GAAG,EAAE,oBAAoB,IAAI,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC;YAC9E,OAAO,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC;gBACtC,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI;gBAC7B,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,oBAAoB;gBAC/C,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,gCAAgC,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;aACtF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,6BAA6B,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAsB,CAAC;AAE9D,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,WAAW,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;CACpC,CAAC;AAEX,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAC9C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAC1C,MAAM,CAAC,MAAM,kCAAkC,GAAG,MAAM,CAAC;AACzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAMrD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS,EAAE,WAAW;IACtB,mBAAmB,EAAE,qBAAqB;IAC1C,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAW,CAAC;AAChD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAW,CAAC;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAW,CAAC;AACjD,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAW,CAAC;AAErD,MAAM,UAAU,sBAAsB;IACpC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,sCAAsC;IACpD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,oBAAoB,KAAU,CAAC;AAC/C,MAAM,UAAU,2BAA2B,KAAU,CAAC;AACtD,MAAM,UAAU,wBAAwB,KAAU,CAAC;AAEnD,MAAM,UAAU,uBAAuB,CAAC,GAAY;IAClD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1G,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzG,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAI,KAAQ;IAChD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,IAAI,KAAK,CACb,wGAAwG,CACzG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,IAAI,KAAK,CACb,8FAA8F,CAC/F,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAA8B,EAC9B,UAAkB,EAClB,WAAmB;IAEnB,OAAO,sCAAsC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;AACrF,CAAC"}

package/dist/execution-matrix/memory-store.d.ts

@@ -0,0 +1,20 @@
+/**
+ * In-memory row/failure collections for tests and local dev when Mongo is unavailable.
+ * Satisfies the subset of {@link @x12i/xronox-store#XronoxCollection} used by {@link ExecutionMatrixRuntime}.
+ */
+import type { XronoxCollection } from '@x12i/xronox-store';
+import type { ReadManyOptions } from '@x12i/xronox-store';
+export declare class MemoryMatrixCollection implements Pick<XronoxCollection<Record<string, unknown>>, 'insert' | 'getByKey' | 'readMany' | 'update' | 'countMatching'> {
+    private readonly pk;
+    private readonly docs;
+    constructor(pk?: string);
+    insert(doc: Partial<Record<string, unknown>>): Promise<string>;
+    getByKey(keyValue: string): Promise<Record<string, unknown> | null>;
+    readMany(filter: Record<string, unknown>, options?: ReadManyOptions & {
+        skip?: number;
+    }): Promise<Record<string, unknown>[]>;
+    countMatching(filter: Record<string, unknown>): Promise<number>;
+    update(keyValue: string, doc: Partial<Record<string, unknown>>): Promise<void>;
+    asCollection(): XronoxCollection<Record<string, unknown>>;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/execution-matrix/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/memory-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAyH1D,qBAAa,sBAAuB,YAAW,IAAI,CACjD,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,eAAe,CAChE;IACC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8C;gBAEvD,EAAE,GAAE,MAAsB;IAIhC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAa9D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAKnE,QAAQ,CACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,eAAe,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAsB/B,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpF,YAAY,IAAI,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAG1D"}