@nest-yalc-2/omnikernel-module 1.1.0

package/src/omnikernel.diagnostics.ts

@@ -0,0 +1,83 @@
+import type { DataSource } from 'typeorm';
+
+export interface OmniKernelQueryPlanEvidence {
+  dialect: 'sqlite' | 'postgres';
+  recordGridPlan: readonly string[];
+  relationSourcePlan: readonly string[];
+  usesRecordGridIndex: boolean;
+  usesRelationSourceIndex: boolean;
+}
+
+const recordGridIndex = 'omni_record_scope_kind_status_guid_idx';
+const relationSourceIndex =
+  'omni_relation_scope_source_kind_status_created_guid_idx';
+
+/**
+ * Bounded operator evidence for the two high-fanout generated read shapes.
+ * This is diagnostic-only: CRUD continues to use the normal TypeORM path.
+ */
+export async function collectOmniKernelQueryPlanEvidence(
+  dataSource: DataSource,
+  sample: {
+    scopeId: string;
+    recordKind: string;
+    recordStatus: string;
+    sourceRecordId: string;
+    relationKind: string;
+    relationStatus: string;
+  },
+): Promise<OmniKernelQueryPlanEvidence> {
+  const dialect = dataSource.options.type;
+  if (dialect !== 'sqlite' && dialect !== 'postgres') {
+    throw new TypeError(
+      'OmniKernel diagnostics support sqlite and postgres only.',
+    );
+  }
+
+  const statements =
+    dialect === 'sqlite'
+      ? {
+          record: `EXPLAIN QUERY PLAN SELECT "guid" FROM "omni-record" WHERE "scopeId" = ? AND "kind" = ? AND "status" = ? AND "deletedAt" IS NULL ORDER BY "guid"`,
+          relation: `EXPLAIN QUERY PLAN SELECT "guid" FROM "omni-relation" WHERE "scopeId" = ? AND "sourceRecordId" = ? AND "kind" = ? AND "status" = ? ORDER BY "createdAt", "guid"`,
+        }
+      : {
+          record: `EXPLAIN (FORMAT JSON) SELECT "guid" FROM "omni-record" WHERE "scopeId" = $1 AND "kind" = $2 AND "status" = $3 AND "deletedAt" IS NULL ORDER BY "guid"`,
+          relation: `EXPLAIN (FORMAT JSON) SELECT "guid" FROM "omni-relation" WHERE "scopeId" = $1 AND "sourceRecordId" = $2 AND "kind" = $3 AND "status" = $4 ORDER BY "createdAt", "guid"`,
+        };
+
+  const recordResult = await dataSource.query(statements.record, [
+    sample.scopeId,
+    sample.recordKind,
+    sample.recordStatus,
+  ]);
+  const relationResult = await dataSource.query(statements.relation, [
+    sample.scopeId,
+    sample.sourceRecordId,
+    sample.relationKind,
+    sample.relationStatus,
+  ]);
+  const recordGridPlan = flattenPlan(recordResult);
+  const relationSourcePlan = flattenPlan(relationResult);
+
+  return {
+    dialect,
+    recordGridPlan,
+    relationSourcePlan,
+    usesRecordGridIndex: containsIndex(recordGridPlan, recordGridIndex),
+    usesRelationSourceIndex: containsIndex(
+      relationSourcePlan,
+      relationSourceIndex,
+    ),
+  };
+}
+
+function flattenPlan(result: unknown): string[] {
+  return JSON.stringify(result)
+    .replaceAll('\\n', ' ')
+    .split(/(?<=\}),|\n/)
+    .filter((line) => line.length > 0);
+}
+
+function containsIndex(plan: readonly string[], indexName: string): boolean {
+  return plan.some((line) => line.includes(indexName));
+}

package/src/omnikernel.module.d.ts

@@ -0,0 +1,5 @@
+import { DynamicModule } from '@nestjs/common';
+import { type OmniKernelRegistrationOptions } from './omni-scope.js';
+export declare class OmniKernelModule {
+    static register(registration: string | OmniKernelRegistrationOptions): DynamicModule;
+}

package/src/omnikernel.module.js

@@ -0,0 +1,87 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var OmniKernelModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OmniKernelModule = void 0;
+const common_1 = require("@nestjs/common");
+const event_emitter_1 = require("@nestjs/event-emitter");
+const typeorm_1 = require("@nestjs/typeorm");
+const omni_external_ref_entity_js_1 = require("./base/omni-external-ref.entity.js");
+const omni_named_entity_js_1 = require("./base/omni-named.entity.js");
+const omni_record_entity_js_1 = require("./base/omni-record.entity.js");
+const omni_relation_entity_js_1 = require("./base/omni-relation.entity.js");
+const omni_collection_entity_js_1 = require("./omni-collection.entity.js");
+const omni_collection_backend_js_1 = require("./omni-collection.backend.js");
+const omni_document_entity_js_1 = require("./omni-document.entity.js");
+const omni_document_backend_js_1 = require("./omni-document.backend.js");
+const omni_external_ref_backend_js_1 = require("./omni-external-ref.backend.js");
+const omni_named_backend_js_1 = require("./omni-named.backend.js");
+const omni_record_backend_js_1 = require("./omni-record.backend.js");
+const omni_relation_backend_js_1 = require("./omni-relation.backend.js");
+const omnikernel_query_service_js_1 = require("./omnikernel.query.service.js");
+const omni_scope_js_1 = require("./omni-scope.js");
+let OmniKernelModule = OmniKernelModule_1 = class OmniKernelModule {
+    static register(registration) {
+        const options = (0, omni_scope_js_1.normalizeOmniKernelRegistrationOptions)(registration);
+        const { dbConnection } = options;
+        const omniNamedProviders = (0, omni_named_backend_js_1.omniNamedBackendProvidersFactory)(dbConnection).providers;
+        const omniRecordProviders = (0, omni_record_backend_js_1.omniRecordBackendProvidersFactory)(dbConnection, options.reservedRecordKinds).providers;
+        const omniRelationProviders = (0, omni_relation_backend_js_1.omniRelationBackendProvidersFactory)(dbConnection).providers;
+        const omniCollectionProviders = (0, omni_collection_backend_js_1.omniCollectionBackendProvidersFactory)(dbConnection).providers;
+        const omniDocumentProviders = (0, omni_document_backend_js_1.omniDocumentBackendProvidersFactory)(dbConnection).providers;
+        const omniExternalRefProviders = (0, omni_external_ref_backend_js_1.omniExternalRefBackendProvidersFactory)(dbConnection).providers;
+        const omniKernelQueryServiceProvider = (0, omnikernel_query_service_js_1.omniKernelQueryServiceProviderFactory)(dbConnection);
+        const eventEmitter = new event_emitter_1.EventEmitter2();
+        return {
+            module: OmniKernelModule_1,
+            imports: [
+                typeorm_1.TypeOrmModule.forFeature([
+                    omni_named_entity_js_1.OmniNamedEntity,
+                    omni_record_entity_js_1.OmniRecordEntity,
+                    omni_relation_entity_js_1.OmniRelationEntity,
+                    omni_collection_entity_js_1.OmniCollectionEntity,
+                    omni_document_entity_js_1.OmniDocumentEntity,
+                    omni_external_ref_entity_js_1.OmniExternalRefEntity,
+                ], dbConnection),
+            ],
+            providers: [
+                { provide: omni_scope_js_1.OMNI_KERNEL_OPTIONS, useValue: options },
+                omni_scope_js_1.OmniScopeContext,
+                {
+                    provide: event_emitter_1.EventEmitter2,
+                    useValue: eventEmitter,
+                },
+                ...omniNamedProviders,
+                ...omniRecordProviders,
+                ...omniRelationProviders,
+                ...omniCollectionProviders,
+                ...omniDocumentProviders,
+                ...omniExternalRefProviders,
+                omniKernelQueryServiceProvider,
+            ],
+            exports: [
+                omni_scope_js_1.OMNI_KERNEL_OPTIONS,
+                omni_scope_js_1.OmniScopeContext,
+                event_emitter_1.EventEmitter2,
+                ...omniNamedProviders,
+                ...omniRecordProviders,
+                ...omniRelationProviders,
+                ...omniCollectionProviders,
+                ...omniDocumentProviders,
+                ...omniExternalRefProviders,
+                omniKernelQueryServiceProvider,
+                omnikernel_query_service_js_1.OmniKernelQueryService,
+            ],
+        };
+    }
+};
+exports.OmniKernelModule = OmniKernelModule;
+exports.OmniKernelModule = OmniKernelModule = OmniKernelModule_1 = __decorate([
+    (0, common_1.Module)({})
+], OmniKernelModule);
+//# sourceMappingURL=omnikernel.module.js.map

package/src/omnikernel.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omnikernel.module.js","sourceRoot":"","sources":["omnikernel.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,yDAAsD;AACtD,6CAAgD;AAChD,oFAA2E;AAC3E,sEAA8D;AAC9D,wEAAgE;AAChE,4EAAoE;AACpE,2EAAmE;AACnE,6EAAqF;AACrF,uEAA+D;AAC/D,yEAAiF;AACjF,iFAAwF;AACxF,mEAA2E;AAC3E,qEAA6E;AAC7E,yEAAiF;AACjF,+EAGuC;AACvC,mDAKyB;AAGlB,IAAM,gBAAgB,wBAAtB,MAAM,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CACb,YAAoD;QAEpD,MAAM,OAAO,GAAG,IAAA,sDAAsC,EAAC,YAAY,CAAC,CAAC;QACrE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;QACjC,MAAM,kBAAkB,GACtB,IAAA,wDAAgC,EAAC,YAAY,CAAC,CAAC,SAAS,CAAC;QAC3D,MAAM,mBAAmB,GAAG,IAAA,0DAAiC,EAC3D,YAAY,EACZ,OAAO,CAAC,mBAAmB,CAC5B,CAAC,SAAS,CAAC;QACZ,MAAM,qBAAqB,GACzB,IAAA,8DAAmC,EAAC,YAAY,CAAC,CAAC,SAAS,CAAC;QAC9D,MAAM,uBAAuB,GAC3B,IAAA,kEAAqC,EAAC,YAAY,CAAC,CAAC,SAAS,CAAC;QAChE,MAAM,qBAAqB,GACzB,IAAA,8DAAmC,EAAC,YAAY,CAAC,CAAC,SAAS,CAAC;QAC9D,MAAM,wBAAwB,GAC5B,IAAA,qEAAsC,EAAC,YAAY,CAAC,CAAC,SAAS,CAAC;QACjE,MAAM,8BAA8B,GAClC,IAAA,mEAAqC,EAAC,YAAY,CAAC,CAAC;QACtD,MAAM,YAAY,GAAG,IAAI,6BAAa,EAAE,CAAC;QAEzC,OAAO;YACL,MAAM,EAAE,kBAAgB;YACxB,OAAO,EAAE;gBACP,uBAAa,CAAC,UAAU,CACtB;oBACE,sCAAe;oBACf,wCAAgB;oBAChB,4CAAkB;oBAClB,gDAAoB;oBACpB,4CAAkB;oBAClB,mDAAqB;iBACtB,EACD,YAAY,CACb;aACF;YACD,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,mCAAmB,EAAE,QAAQ,EAAE,OAAO,EAAE;gBACnD,gCAAgB;gBAChB;oBACE,OAAO,EAAE,6BAAa;oBACtB,QAAQ,EAAE,YAAY;iBACvB;gBACD,GAAG,kBAAkB;gBACrB,GAAG,mBAAmB;gBACtB,GAAG,qBAAqB;gBACxB,GAAG,uBAAuB;gBAC1B,GAAG,qBAAqB;gBACxB,GAAG,wBAAwB;gBAC3B,8BAA8B;aAC/B;YACD,OAAO,EAAE;gBACP,mCAAmB;gBACnB,gCAAgB;gBAChB,6BAAa;gBACb,GAAG,kBAAkB;gBACrB,GAAG,mBAAmB;gBACtB,GAAG,qBAAqB;gBACxB,GAAG,uBAAuB;gBAC1B,GAAG,qBAAqB;gBACxB,GAAG,wBAAwB;gBAC3B,8BAA8B;gBAC9B,oDAAsB;aACvB;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AArEY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,gBAAgB,CAqE5B"}

package/src/omnikernel.module.ts

@@ -0,0 +1,97 @@
+import { DynamicModule, Module } from '@nestjs/common';
+import { EventEmitter2 } from '@nestjs/event-emitter';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { OmniExternalRefEntity } from './base/omni-external-ref.entity.js';
+import { OmniNamedEntity } from './base/omni-named.entity.js';
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+import { OmniRelationEntity } from './base/omni-relation.entity.js';
+import { OmniCollectionEntity } from './omni-collection.entity.js';
+import { omniCollectionBackendProvidersFactory } from './omni-collection.backend.js';
+import { OmniDocumentEntity } from './omni-document.entity.js';
+import { omniDocumentBackendProvidersFactory } from './omni-document.backend.js';
+import { omniExternalRefBackendProvidersFactory } from './omni-external-ref.backend.js';
+import { omniNamedBackendProvidersFactory } from './omni-named.backend.js';
+import { omniRecordBackendProvidersFactory } from './omni-record.backend.js';
+import { omniRelationBackendProvidersFactory } from './omni-relation.backend.js';
+import {
+  OmniKernelQueryService,
+  omniKernelQueryServiceProviderFactory,
+} from './omnikernel.query.service.js';
+import {
+  OMNI_KERNEL_OPTIONS,
+  OmniScopeContext,
+  normalizeOmniKernelRegistrationOptions,
+  type OmniKernelRegistrationOptions,
+} from './omni-scope.js';
+
+@Module({})
+export class OmniKernelModule {
+  static register(
+    registration: string | OmniKernelRegistrationOptions,
+  ): DynamicModule {
+    const options = normalizeOmniKernelRegistrationOptions(registration);
+    const { dbConnection } = options;
+    const omniNamedProviders =
+      omniNamedBackendProvidersFactory(dbConnection).providers;
+    const omniRecordProviders = omniRecordBackendProvidersFactory(
+      dbConnection,
+      options.reservedRecordKinds,
+    ).providers;
+    const omniRelationProviders =
+      omniRelationBackendProvidersFactory(dbConnection).providers;
+    const omniCollectionProviders =
+      omniCollectionBackendProvidersFactory(dbConnection).providers;
+    const omniDocumentProviders =
+      omniDocumentBackendProvidersFactory(dbConnection).providers;
+    const omniExternalRefProviders =
+      omniExternalRefBackendProvidersFactory(dbConnection).providers;
+    const omniKernelQueryServiceProvider =
+      omniKernelQueryServiceProviderFactory(dbConnection);
+    const eventEmitter = new EventEmitter2();
+
+    return {
+      module: OmniKernelModule,
+      imports: [
+        TypeOrmModule.forFeature(
+          [
+            OmniNamedEntity,
+            OmniRecordEntity,
+            OmniRelationEntity,
+            OmniCollectionEntity,
+            OmniDocumentEntity,
+            OmniExternalRefEntity,
+          ],
+          dbConnection,
+        ),
+      ],
+      providers: [
+        { provide: OMNI_KERNEL_OPTIONS, useValue: options },
+        OmniScopeContext,
+        {
+          provide: EventEmitter2,
+          useValue: eventEmitter,
+        },
+        ...omniNamedProviders,
+        ...omniRecordProviders,
+        ...omniRelationProviders,
+        ...omniCollectionProviders,
+        ...omniDocumentProviders,
+        ...omniExternalRefProviders,
+        omniKernelQueryServiceProvider,
+      ],
+      exports: [
+        OMNI_KERNEL_OPTIONS,
+        OmniScopeContext,
+        EventEmitter2,
+        ...omniNamedProviders,
+        ...omniRecordProviders,
+        ...omniRelationProviders,
+        ...omniCollectionProviders,
+        ...omniDocumentProviders,
+        ...omniExternalRefProviders,
+        omniKernelQueryServiceProvider,
+        OmniKernelQueryService,
+      ],
+    };
+  }
+}

package/src/omnikernel.query.service.d.ts

@@ -0,0 +1,17 @@
+import { FactoryProvider } from '@nestjs/common';
+import { Repository } from 'typeorm';
+import { OmniExternalRefEntity } from './base/omni-external-ref.entity.js';
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+import { OmniRelationEntity } from './base/omni-relation.entity.js';
+import { OmniCollectionEntity } from './omni-collection.entity.js';
+import { type OmniScope } from './omni-scope.js';
+export declare class OmniKernelQueryService {
+    protected relationRepository: Repository<OmniRelationEntity>;
+    protected externalRefRepository: Repository<OmniExternalRefEntity>;
+    protected readonly scope: OmniScope;
+    constructor(relationRepository: Repository<OmniRelationEntity>, externalRefRepository: Repository<OmniExternalRefEntity>, scope?: OmniScope);
+    getCollectionMembers(collectionId: string): Promise<OmniRecordEntity[]>;
+    getDocumentCollections(documentId: string): Promise<OmniCollectionEntity[]>;
+    getDocumentExternalRefs(documentId: string, provider?: string): Promise<OmniExternalRefEntity[]>;
+}
+export declare const omniKernelQueryServiceProviderFactory: (dbConnection: string) => FactoryProvider<OmniKernelQueryService>;

package/src/omnikernel.query.service.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.omniKernelQueryServiceProviderFactory = exports.OmniKernelQueryService = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const omni_external_ref_entity_js_1 = require("./base/omni-external-ref.entity.js");
+const omni_relation_entity_js_1 = require("./base/omni-relation.entity.js");
+const omni_external_ref_internal_type_enum_js_1 = require("./omni-external-ref-internal-type.enum.js");
+const omni_relation_kind_enum_js_1 = require("./omni-relation-kind.enum.js");
+const omni_relation_status_enum_js_1 = require("./omni-relation-status.enum.js");
+const omni_relation_semantics_js_1 = require("./omni-relation-semantics.js");
+const omni_scope_js_1 = require("./omni-scope.js");
+const defaultQueryScope = {
+    scopeId: 'default',
+    cacheKey: (key) => `default:${key}`,
+};
+class OmniKernelQueryService {
+    constructor(relationRepository, externalRefRepository, scope = defaultQueryScope) {
+        this.relationRepository = relationRepository;
+        this.externalRefRepository = externalRefRepository;
+        this.scope = scope;
+    }
+    async getCollectionMembers(collectionId) {
+        const relations = await this.relationRepository.find({
+            where: {
+                scopeId: this.scope.scopeId,
+                sourceRecordId: collectionId,
+                kind: omni_relation_kind_enum_js_1.OmniRelationKind.Contains,
+                status: omni_relation_status_enum_js_1.OmniRelationStatus.Active,
+            },
+            relations: {
+                targetRecord: true,
+            },
+            order: {
+                createdAt: 'ASC',
+            },
+        });
+        return relations.map((relation) => relation.targetRecord);
+    }
+    async getDocumentCollections(documentId) {
+        const relations = await this.relationRepository.find({
+            where: {
+                scopeId: this.scope.scopeId,
+                targetRecordId: documentId,
+                kind: omni_relation_kind_enum_js_1.OmniRelationKind.Contains,
+                status: omni_relation_status_enum_js_1.OmniRelationStatus.Active,
+            },
+            relations: {
+                sourceRecord: true,
+            },
+            order: {
+                createdAt: 'ASC',
+            },
+        });
+        return relations
+            .map((relation) => relation.sourceRecord)
+            .filter((record) => !!record && (0, omni_relation_semantics_js_1.isOmniCollectionRecordKind)(record.kind));
+    }
+    async getDocumentExternalRefs(documentId, provider) {
+        return this.externalRefRepository.find({
+            where: {
+                scopeId: this.scope.scopeId,
+                internalType: omni_external_ref_internal_type_enum_js_1.OmniExternalRefInternalType.Document,
+                internalId: documentId,
+                ...(provider ? { provider } : {}),
+            },
+            order: {
+                createdAt: 'ASC',
+            },
+        });
+    }
+}
+exports.OmniKernelQueryService = OmniKernelQueryService;
+const omniKernelQueryServiceProviderFactory = (dbConnection) => ({
+    provide: OmniKernelQueryService,
+    scope: common_1.Scope.REQUEST,
+    useFactory: (relationRepository, externalRefRepository, scope) => new OmniKernelQueryService(relationRepository, externalRefRepository, scope),
+    inject: [
+        (0, typeorm_1.getRepositoryToken)(omni_relation_entity_js_1.OmniRelationEntity, dbConnection),
+        (0, typeorm_1.getRepositoryToken)(omni_external_ref_entity_js_1.OmniExternalRefEntity, dbConnection),
+        omni_scope_js_1.OmniScopeContext,
+    ],
+});
+exports.omniKernelQueryServiceProviderFactory = omniKernelQueryServiceProviderFactory;
+//# sourceMappingURL=omnikernel.query.service.js.map

package/src/omnikernel.query.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omnikernel.query.service.js","sourceRoot":"","sources":["omnikernel.query.service.ts"],"names":[],"mappings":";;;AAAA,2CAAwD;AACxD,6CAAqD;AAErD,oFAA2E;AAE3E,4EAAoE;AAEpE,uGAAwF;AACxF,6EAAgE;AAChE,iFAAoE;AACpE,6EAA0E;AAC1E,mDAAmE;AAEnE,MAAM,iBAAiB,GAAc;IACnC,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,GAAG,EAAE;CACpC,CAAC;AAEF,MAAa,sBAAsB;IACjC,YACY,kBAAkD,EAClD,qBAAwD,EAC/C,QAAmB,iBAAiB;QAF7C,uBAAkB,GAAlB,kBAAkB,CAAgC;QAClD,0BAAqB,GAArB,qBAAqB,CAAmC;QAC/C,UAAK,GAAL,KAAK,CAA+B;IACtD,CAAC;IAEJ,KAAK,CAAC,oBAAoB,CACxB,YAAoB;QAEpB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;YACnD,KAAK,EAAE;gBACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;gBAC3B,cAAc,EAAE,YAAY;gBAC5B,IAAI,EAAE,6CAAgB,CAAC,QAAQ;gBAC/B,MAAM,EAAE,iDAAkB,CAAC,MAAM;aAClC;YACD,SAAS,EAAE;gBACT,YAAY,EAAE,IAAI;aACnB;YACD,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK;aACjB;SACF,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,sBAAsB,CAC1B,UAAkB;QAElB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;YACnD,KAAK,EAAE;gBACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;gBAC3B,cAAc,EAAE,UAAU;gBAC1B,IAAI,EAAE,6CAAgB,CAAC,QAAQ;gBAC/B,MAAM,EAAE,iDAAkB,CAAC,MAAM;aAClC;YACD,SAAS,EAAE;gBACT,YAAY,EAAE,IAAI;aACnB;YACD,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK;aACjB;SACF,CAAC,CAAC;QAEH,OAAO,SAAS;aACb,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;aACxC,MAAM,CACL,CAAC,MAAM,EAAkC,EAAE,CACzC,CAAC,CAAC,MAAM,IAAI,IAAA,uDAA0B,EAAC,MAAM,CAAC,IAAI,CAAC,CACtD,CAAC;IACN,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,UAAkB,EAAE,QAAiB;QACjE,OAAO,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC;YACrC,KAAK,EAAE;gBACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;gBAC3B,YAAY,EAAE,qEAA2B,CAAC,QAAQ;gBAClD,UAAU,EAAE,UAAU;gBACtB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClC;YACD,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK;aACjB;SACF,CAAC,CAAC;IACL,CAAC;CACF;AAnED,wDAmEC;AAEM,MAAM,qCAAqC,GAAG,CACnD,YAAoB,EACqB,EAAE,CAAC,CAAC;IAC7C,OAAO,EAAE,sBAAsB;IAC/B,KAAK,EAAE,cAAK,CAAC,OAAO;IACpB,UAAU,EAAE,CACV,kBAAkD,EAClD,qBAAwD,EACxD,KAAgB,EAChB,EAAE,CACF,IAAI,sBAAsB,CACxB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,CACN;IACH,MAAM,EAAE;QACN,IAAA,4BAAkB,EAAC,4CAAkB,EAAE,YAAY,CAAC;QACpD,IAAA,4BAAkB,EAAC,mDAAqB,EAAE,YAAY,CAAC;QACvD,gCAAgB;KACjB;CACF,CAAC,CAAC;AApBU,QAAA,qCAAqC,yCAoB/C"}

package/src/omnikernel.query.service.ts

@@ -0,0 +1,108 @@
+import { FactoryProvider, Scope } from '@nestjs/common';
+import { getRepositoryToken } from '@nestjs/typeorm';
+import { Repository } from 'typeorm';
+import { OmniExternalRefEntity } from './base/omni-external-ref.entity.js';
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+import { OmniRelationEntity } from './base/omni-relation.entity.js';
+import { OmniCollectionEntity } from './omni-collection.entity.js';
+import { OmniExternalRefInternalType } from './omni-external-ref-internal-type.enum.js';
+import { OmniRelationKind } from './omni-relation-kind.enum.js';
+import { OmniRelationStatus } from './omni-relation-status.enum.js';
+import { isOmniCollectionRecordKind } from './omni-relation-semantics.js';
+import { OmniScopeContext, type OmniScope } from './omni-scope.js';
+
+const defaultQueryScope: OmniScope = {
+  scopeId: 'default',
+  cacheKey: (key) => `default:${key}`,
+};
+
+export class OmniKernelQueryService {
+  constructor(
+    protected relationRepository: Repository<OmniRelationEntity>,
+    protected externalRefRepository: Repository<OmniExternalRefEntity>,
+    protected readonly scope: OmniScope = defaultQueryScope,
+  ) {}
+
+  async getCollectionMembers(
+    collectionId: string,
+  ): Promise<OmniRecordEntity[]> {
+    const relations = await this.relationRepository.find({
+      where: {
+        scopeId: this.scope.scopeId,
+        sourceRecordId: collectionId,
+        kind: OmniRelationKind.Contains,
+        status: OmniRelationStatus.Active,
+      },
+      relations: {
+        targetRecord: true,
+      },
+      order: {
+        createdAt: 'ASC',
+      },
+    });
+
+    return relations.map((relation) => relation.targetRecord);
+  }
+
+  async getDocumentCollections(
+    documentId: string,
+  ): Promise<OmniCollectionEntity[]> {
+    const relations = await this.relationRepository.find({
+      where: {
+        scopeId: this.scope.scopeId,
+        targetRecordId: documentId,
+        kind: OmniRelationKind.Contains,
+        status: OmniRelationStatus.Active,
+      },
+      relations: {
+        sourceRecord: true,
+      },
+      order: {
+        createdAt: 'ASC',
+      },
+    });
+
+    return relations
+      .map((relation) => relation.sourceRecord)
+      .filter(
+        (record): record is OmniCollectionEntity =>
+          !!record && isOmniCollectionRecordKind(record.kind),
+      );
+  }
+
+  async getDocumentExternalRefs(documentId: string, provider?: string) {
+    return this.externalRefRepository.find({
+      where: {
+        scopeId: this.scope.scopeId,
+        internalType: OmniExternalRefInternalType.Document,
+        internalId: documentId,
+        ...(provider ? { provider } : {}),
+      },
+      order: {
+        createdAt: 'ASC',
+      },
+    });
+  }
+}
+
+export const omniKernelQueryServiceProviderFactory = (
+  dbConnection: string,
+): FactoryProvider<OmniKernelQueryService> => ({
+  provide: OmniKernelQueryService,
+  scope: Scope.REQUEST,
+  useFactory: (
+    relationRepository: Repository<OmniRelationEntity>,
+    externalRefRepository: Repository<OmniExternalRefEntity>,
+    scope: OmniScope,
+  ) =>
+    new OmniKernelQueryService(
+      relationRepository,
+      externalRefRepository,
+      scope,
+    ),
+  inject: [
+    getRepositoryToken(OmniRelationEntity, dbConnection),
+    getRepositoryToken(OmniExternalRefEntity, dbConnection),
+    OmniScopeContext,
+  ],
+});