@nest-yalc-2/omnikernel-module 1.1.0

package/src/omni-relation-semantics.ts

@@ -0,0 +1,52 @@
+import { OmniCollectionKind } from './omni-collection-kind.enum.js';
+import { OmniDocumentKind } from './omni-document-kind.enum.js';
+import { OmniRelationKind } from './omni-relation-kind.enum.js';
+
+export interface OmniRelationSemanticsInput {
+  sourceKind: string;
+  targetKind: string;
+  relationKind: string;
+}
+
+export const OMNI_COLLECTION_MEMBERSHIP_RELATION_KIND =
+  OmniRelationKind.Contains;
+
+const hasKind = (kind: string): boolean => kind.trim().length > 0;
+
+export const isOmniCollectionRecordKind = (kind: string): boolean =>
+  kind === OmniCollectionKind.Collection;
+
+export const isOmniDocumentRecordKind = (kind: string): boolean =>
+  kind === OmniDocumentKind.Document;
+
+export const isCanonicalCollectionMembershipRelation = ({
+  sourceKind,
+  relationKind,
+}: Pick<OmniRelationSemanticsInput, 'sourceKind' | 'relationKind'>): boolean =>
+  relationKind === OMNI_COLLECTION_MEMBERSHIP_RELATION_KIND &&
+  isOmniCollectionRecordKind(sourceKind);
+
+export const isAllowedOmniRelation = ({
+  sourceKind,
+  targetKind,
+  relationKind,
+}: OmniRelationSemanticsInput): boolean => {
+  if (!hasKind(sourceKind) || !hasKind(targetKind)) {
+    return false;
+  }
+
+  switch (relationKind) {
+    case OmniRelationKind.Contains:
+      return isOmniCollectionRecordKind(sourceKind);
+    case OmniRelationKind.DerivedFrom:
+      return (
+        isOmniDocumentRecordKind(sourceKind) &&
+        isOmniDocumentRecordKind(targetKind)
+      );
+    case OmniRelationKind.References:
+    case OmniRelationKind.RelatedTo:
+      return true;
+    default:
+      return false;
+  }
+};

package/src/omni-relation-status.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum OmniRelationStatus {
+    Active = "active",
+    Inactive = "inactive",
+    Archived = "archived"
+}

package/src/omni-relation-status.enum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OmniRelationStatus = void 0;
+const graphql_1 = require("@nestjs/graphql");
+var OmniRelationStatus;
+(function (OmniRelationStatus) {
+    OmniRelationStatus["Active"] = "active";
+    OmniRelationStatus["Inactive"] = "inactive";
+    OmniRelationStatus["Archived"] = "archived";
+})(OmniRelationStatus || (exports.OmniRelationStatus = OmniRelationStatus = {}));
+(0, graphql_1.registerEnumType)(OmniRelationStatus, {
+    name: 'OmniRelationStatus',
+});
+//# sourceMappingURL=omni-relation-status.enum.js.map

package/src/omni-relation-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omni-relation-status.enum.js","sourceRoot":"","sources":["omni-relation-status.enum.ts"],"names":[],"mappings":";;;AAAA,6CAAmD;AAEnD,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,2CAAqB,CAAA;IACrB,2CAAqB,CAAA;AACvB,CAAC,EAJW,kBAAkB,kCAAlB,kBAAkB,QAI7B;AAED,IAAA,0BAAgB,EAAC,kBAAkB,EAAE;IACnC,IAAI,EAAE,oBAAoB;CAC3B,CAAC,CAAC"}

package/src/omni-relation-status.enum.ts

@@ -0,0 +1,11 @@
+import { registerEnumType } from '@nestjs/graphql';
+
+export enum OmniRelationStatus {
+  Active = 'active',
+  Inactive = 'inactive',
+  Archived = 'archived',
+}
+
+registerEnumType(OmniRelationStatus, {
+  name: 'OmniRelationStatus',
+});

package/src/omni-relation.backend.d.ts

@@ -0,0 +1,2 @@
+import { OmniRelationEntity } from './base/omni-relation.entity.js';
+export declare const omniRelationBackendProvidersFactory: (dbConnection: string) => import("./omni-scoped.backend.js").OmniScopedBackendFactoryResult<OmniRelationEntity>;

package/src/omni-relation.backend.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.omniRelationBackendProvidersFactory = void 0;
+const typeorm_1 = require("@nestjs/typeorm");
+const omni_relation_entity_js_1 = require("./base/omni-relation.entity.js");
+const omni_record_entity_js_1 = require("./base/omni-record.entity.js");
+const omni_relation_kind_contract_js_1 = require("./omni-relation-kind.contract.js");
+const omni_relation_service_js_1 = require("./omni-relation.service.js");
+const omni_scoped_backend_js_1 = require("./omni-scoped.backend.js");
+const omniRelationBackendProvidersFactory = (dbConnection) => (0, omni_scoped_backend_js_1.omniScopedBackendProvidersFactory)({
+    entityModel: omni_relation_entity_js_1.OmniRelationEntity,
+    dbConnection,
+    additionalInject: [(0, typeorm_1.getRepositoryToken)(omni_record_entity_js_1.OmniRecordEntity, dbConnection)],
+    createService: (repository, scope, options, recordRepository) => new omni_relation_service_js_1.OmniRelationService(repository, scope, options.deletion.relation, recordRepository, (0, omni_relation_kind_contract_js_1.createOmniRelationKindContract)(options.relationKinds)),
+});
+exports.omniRelationBackendProvidersFactory = omniRelationBackendProvidersFactory;
+//# sourceMappingURL=omni-relation.backend.js.map

package/src/omni-relation.backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omni-relation.backend.js","sourceRoot":"","sources":["omni-relation.backend.ts"],"names":[],"mappings":";;;AAAA,6CAAqD;AACrD,4EAAoE;AACpE,wEAAgE;AAChE,qFAAkF;AAClF,yEAAiE;AACjE,qEAA6E;AAEtE,MAAM,mCAAmC,GAAG,CAAC,YAAoB,EAAE,EAAE,CAC1E,IAAA,0DAAiC,EAAqB;IACpD,WAAW,EAAE,4CAAkB;IAC/B,YAAY;IACZ,gBAAgB,EAAE,CAAC,IAAA,4BAAkB,EAAC,wCAAgB,EAAE,YAAY,CAAC,CAAC;IACtE,aAAa,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,CAC9D,IAAI,8CAAmB,CACrB,UAAU,EACV,KAAK,EACL,OAAO,CAAC,QAAQ,CAAC,QAAQ,EACzB,gBAAyB,EACzB,IAAA,+DAA8B,EAAC,OAAO,CAAC,aAAa,CAAC,CACtD;CACJ,CAAC,CAAC;AAbQ,QAAA,mCAAmC,uCAa3C"}

package/src/omni-relation.backend.ts

@@ -0,0 +1,21 @@
+import { getRepositoryToken } from '@nestjs/typeorm';
+import { OmniRelationEntity } from './base/omni-relation.entity.js';
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+import { createOmniRelationKindContract } from './omni-relation-kind.contract.js';
+import { OmniRelationService } from './omni-relation.service.js';
+import { omniScopedBackendProvidersFactory } from './omni-scoped.backend.js';
+
+export const omniRelationBackendProvidersFactory = (dbConnection: string) =>
+  omniScopedBackendProvidersFactory<OmniRelationEntity>({
+    entityModel: OmniRelationEntity,
+    dbConnection,
+    additionalInject: [getRepositoryToken(OmniRecordEntity, dbConnection)],
+    createService: (repository, scope, options, recordRepository) =>
+      new OmniRelationService(
+        repository,
+        scope,
+        options.deletion.relation,
+        recordRepository as never,
+        createOmniRelationKindContract(options.relationKinds),
+      ),
+  });

package/src/omni-relation.dto.d.ts

@@ -0,0 +1,28 @@
+import type { Relation } from 'typeorm';
+import { OmniRelationEntity } from './base/omni-relation.entity.js';
+import { OmniRecordType } from './omni-record.dto.js';
+import { OmniRelationStatus } from './omni-relation-status.enum.js';
+export declare class OmniRelationType extends OmniRelationEntity {
+    constructor(data?: Partial<OmniRelationType>);
+    guid: string;
+    revision: number;
+    sourceRecordId: string;
+    sourceRecord: Relation<OmniRecordType>;
+    targetRecordId: string;
+    targetRecord: Relation<OmniRecordType>;
+    kind: string;
+    status: OmniRelationStatus;
+    payload?: Record<string, unknown> | null;
+    payloadSchemaId?: string | null;
+    payloadSchemaVersion?: number | null;
+}
+declare const OmniRelationCreateInput_base: import("@nestjs/common").Type<Omit<OmniRelationType, "revision" | "createdAt" | "updatedAt" | "sourceRecord" | "targetRecord">>;
+export declare class OmniRelationCreateInput extends OmniRelationCreateInput_base {
+}
+declare const OmniRelationCondition_base: import("@nestjs/common").Type<Partial<OmniRelationCreateInput>>;
+export declare class OmniRelationCondition extends OmniRelationCondition_base {
+}
+declare const OmniRelationUpdateInput_base: import("@nestjs/common").Type<Partial<OmniRelationCreateInput>>;
+export declare class OmniRelationUpdateInput extends OmniRelationUpdateInput_base {
+}
+export {};

package/src/omni-relation.dto.js

@@ -0,0 +1,153 @@
+"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 __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OmniRelationUpdateInput = exports.OmniRelationCondition = exports.OmniRelationCreateInput = exports.OmniRelationType = void 0;
+const graphql_1 = require("@nestjs/graphql");
+const object_decorator_js_1 = require("@nest-yalc-2/crud-gen/object.decorator.js");
+const uuid_scalar_js_1 = require("@nest-yalc-2/graphql/scalars/uuid.scalar.js");
+const returnValue_js_1 = __importDefault(require("@nest-yalc-2/utils/returnValue.js"));
+const class_validator_1 = require("class-validator");
+const graphql_type_json_1 = require("graphql-type-json");
+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_dto_helpers_js_1 = require("./omni-dto.helpers.js");
+const omni_record_dto_js_1 = require("./omni-record.dto.js");
+const omni_relation_kind_contract_js_1 = require("./omni-relation-kind.contract.js");
+const omni_relation_status_enum_js_1 = require("./omni-relation-status.enum.js");
+let OmniRelationType = class OmniRelationType extends omni_relation_entity_js_1.OmniRelationEntity {
+    constructor(data) {
+        super();
+        if (data) {
+            (0, omni_dto_helpers_js_1.assignOmniPublicDto)(this, data);
+        }
+    }
+};
+exports.OmniRelationType = OmniRelationType;
+__decorate([
+    (0, object_decorator_js_1.ModelField)({ gqlType: (0, returnValue_js_1.default)(uuid_scalar_js_1.UUIDScalar), isRequired: true }),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], OmniRelationType.prototype, "guid", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({ gqlType: (0, returnValue_js_1.default)(graphql_1.Int) }),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], OmniRelationType.prototype, "revision", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({ gqlType: (0, returnValue_js_1.default)(uuid_scalar_js_1.UUIDScalar), isRequired: true }),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], OmniRelationType.prototype, "sourceRecordId", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({
+        gqlType: () => omni_record_dto_js_1.OmniRecordType,
+        gqlOptions: { nullable: false },
+        relation: {
+            relationType: 'many-to-one',
+            sourceKey: { dst: 'sourceRecordId', alias: 'sourceRecordId' },
+            targetKey: { dst: 'guid', alias: 'guid' },
+            type: () => omni_record_entity_js_1.OmniRecordEntity,
+        },
+    }),
+    __metadata("design:type", Object)
+], OmniRelationType.prototype, "sourceRecord", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({ gqlType: (0, returnValue_js_1.default)(uuid_scalar_js_1.UUIDScalar), isRequired: true }),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], OmniRelationType.prototype, "targetRecordId", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({
+        gqlType: () => omni_record_dto_js_1.OmniRecordType,
+        gqlOptions: { nullable: false },
+        relation: {
+            relationType: 'many-to-one',
+            sourceKey: { dst: 'targetRecordId', alias: 'targetRecordId' },
+            targetKey: { dst: 'guid', alias: 'guid' },
+            type: () => omni_record_entity_js_1.OmniRecordEntity,
+        },
+    }),
+    __metadata("design:type", Object)
+], OmniRelationType.prototype, "targetRecord", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({ gqlType: (0, returnValue_js_1.default)(String) }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(omni_relation_kind_contract_js_1.omniRelationKindPattern),
+    __metadata("design:type", String)
+], OmniRelationType.prototype, "kind", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({ gqlType: (0, returnValue_js_1.default)(omni_relation_status_enum_js_1.OmniRelationStatus) }),
+    (0, class_validator_1.IsEnum)(omni_relation_status_enum_js_1.OmniRelationStatus),
+    __metadata("design:type", String)
+], OmniRelationType.prototype, "status", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({
+        gqlType: (0, returnValue_js_1.default)(graphql_type_json_1.GraphQLJSONObject),
+        gqlOptions: { nullable: true },
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], OmniRelationType.prototype, "payload", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({
+        gqlType: (0, returnValue_js_1.default)(String),
+        gqlOptions: { nullable: true },
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", Object)
+], OmniRelationType.prototype, "payloadSchemaId", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({
+        gqlType: (0, returnValue_js_1.default)(graphql_1.Int),
+        gqlOptions: { nullable: true },
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Object)
+], OmniRelationType.prototype, "payloadSchemaVersion", void 0);
+exports.OmniRelationType = OmniRelationType = __decorate([
+    (0, graphql_1.ObjectType)(),
+    (0, object_decorator_js_1.ModelObject)(),
+    __metadata("design:paramtypes", [Object])
+], OmniRelationType);
+let OmniRelationCreateInput = class OmniRelationCreateInput extends (0, graphql_1.OmitType)(OmniRelationType, [
+    'createdAt',
+    'updatedAt',
+    'revision',
+    'sourceRecord',
+    'targetRecord',
+], graphql_1.InputType) {
+};
+exports.OmniRelationCreateInput = OmniRelationCreateInput;
+exports.OmniRelationCreateInput = OmniRelationCreateInput = __decorate([
+    (0, graphql_1.InputType)(),
+    (0, object_decorator_js_1.ModelObject)()
+], OmniRelationCreateInput);
+let OmniRelationCondition = class OmniRelationCondition extends (0, graphql_1.PartialType)(OmniRelationCreateInput, graphql_1.InputType) {
+};
+exports.OmniRelationCondition = OmniRelationCondition;
+exports.OmniRelationCondition = OmniRelationCondition = __decorate([
+    (0, graphql_1.InputType)(),
+    (0, object_decorator_js_1.ModelObject)({ copyFrom: OmniRelationType })
+], OmniRelationCondition);
+let OmniRelationUpdateInput = class OmniRelationUpdateInput extends (0, graphql_1.PartialType)(OmniRelationCreateInput, graphql_1.InputType) {
+};
+exports.OmniRelationUpdateInput = OmniRelationUpdateInput;
+exports.OmniRelationUpdateInput = OmniRelationUpdateInput = __decorate([
+    (0, graphql_1.InputType)(),
+    (0, object_decorator_js_1.ModelObject)({ copyFrom: OmniRelationType })
+], OmniRelationUpdateInput);
+//# sourceMappingURL=omni-relation.dto.js.map

package/src/omni-relation.dto.js.map

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

package/src/omni-relation.dto.ts

@@ -0,0 +1,142 @@
+import {
+  InputType,
+  Int,
+  ObjectType,
+  OmitType,
+  PartialType,
+} from '@nestjs/graphql';
+import {
+  ModelField,
+  ModelObject,
+} from '@nest-yalc-2/crud-gen/object.decorator.js';
+import { UUIDScalar } from '@nest-yalc-2/graphql/scalars/uuid.scalar.js';
+import returnValue from '@nest-yalc-2/utils/returnValue.js';
+import {
+  IsEnum,
+  IsInt,
+  IsObject,
+  IsOptional,
+  IsString,
+  IsUUID,
+  Matches,
+} from 'class-validator';
+import { GraphQLJSONObject } from 'graphql-type-json';
+import type { Relation } from 'typeorm';
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+import { OmniRelationEntity } from './base/omni-relation.entity.js';
+import { assignOmniPublicDto } from './omni-dto.helpers.js';
+import { OmniRecordType } from './omni-record.dto.js';
+import { omniRelationKindPattern } from './omni-relation-kind.contract.js';
+import { OmniRelationStatus } from './omni-relation-status.enum.js';
+
+@ObjectType()
+@ModelObject()
+export class OmniRelationType extends OmniRelationEntity {
+  constructor(data?: Partial<OmniRelationType>) {
+    super();
+    if (data) {
+      assignOmniPublicDto(this, data);
+    }
+  }
+
+  @ModelField({ gqlType: returnValue(UUIDScalar), isRequired: true })
+  @IsUUID()
+  guid!: string;
+
+  @ModelField({ gqlType: returnValue(Int) })
+  @IsInt()
+  revision!: number;
+
+  @ModelField({ gqlType: returnValue(UUIDScalar), isRequired: true })
+  @IsUUID()
+  sourceRecordId!: string;
+
+  @ModelField({
+    gqlType: () => OmniRecordType,
+    gqlOptions: { nullable: false },
+    relation: {
+      relationType: 'many-to-one',
+      sourceKey: { dst: 'sourceRecordId', alias: 'sourceRecordId' },
+      targetKey: { dst: 'guid', alias: 'guid' },
+      type: () => OmniRecordEntity,
+    },
+  })
+  sourceRecord!: Relation<OmniRecordType>;
+
+  @ModelField({ gqlType: returnValue(UUIDScalar), isRequired: true })
+  @IsUUID()
+  targetRecordId!: string;
+
+  @ModelField({
+    gqlType: () => OmniRecordType,
+    gqlOptions: { nullable: false },
+    relation: {
+      relationType: 'many-to-one',
+      sourceKey: { dst: 'targetRecordId', alias: 'targetRecordId' },
+      targetKey: { dst: 'guid', alias: 'guid' },
+      type: () => OmniRecordEntity,
+    },
+  })
+  targetRecord!: Relation<OmniRecordType>;
+
+  @ModelField({ gqlType: returnValue(String) })
+  @IsString()
+  @Matches(omniRelationKindPattern)
+  kind!: string;
+
+  @ModelField({ gqlType: returnValue(OmniRelationStatus) })
+  @IsEnum(OmniRelationStatus)
+  status!: OmniRelationStatus;
+
+  @ModelField({
+    gqlType: returnValue(GraphQLJSONObject),
+    gqlOptions: { nullable: true },
+  })
+  @IsOptional()
+  @IsObject()
+  payload?: Record<string, unknown> | null;
+
+  @ModelField({
+    gqlType: returnValue(String),
+    gqlOptions: { nullable: true },
+  })
+  @IsOptional()
+  @IsString()
+  payloadSchemaId?: string | null;
+
+  @ModelField({
+    gqlType: returnValue(Int),
+    gqlOptions: { nullable: true },
+  })
+  @IsOptional()
+  @IsInt()
+  payloadSchemaVersion?: number | null;
+}
+
+@InputType()
+@ModelObject()
+export class OmniRelationCreateInput extends OmitType(
+  OmniRelationType,
+  [
+    'createdAt',
+    'updatedAt',
+    'revision',
+    'sourceRecord',
+    'targetRecord',
+  ] as const,
+  InputType,
+) {}
+
+@InputType()
+@ModelObject({ copyFrom: OmniRelationType })
+export class OmniRelationCondition extends PartialType(
+  OmniRelationCreateInput,
+  InputType,
+) {}
+
+@InputType()
+@ModelObject({ copyFrom: OmniRelationType })
+export class OmniRelationUpdateInput extends PartialType(
+  OmniRelationCreateInput,
+  InputType,
+) {}

package/src/omni-relation.service.d.ts

@@ -0,0 +1,19 @@
+import type { CrudGenFindManyOptions } from '@nest-yalc-2/crud-gen/api-graphql/crud-gen-gql.interface.js';
+import { type DeepPartial, type FindOptionsWhere, type Repository } from 'typeorm';
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+import { OmniRelationEntity } from './base/omni-relation.entity.js';
+import { type OmniRelationKindContract } from './omni-relation-kind.contract.js';
+import type { OmniDeletePolicy, OmniScope } from './omni-scope.js';
+import { OmniScopedService } from './omni-scoped.service.js';
+export declare class OmniRelationService extends OmniScopedService<OmniRelationEntity> {
+    protected readonly recordRepository: Repository<OmniRecordEntity>;
+    protected readonly kinds: OmniRelationKindContract;
+    constructor(repository: any, scope: OmniScope, deletion: OmniDeletePolicy, recordRepository: Repository<OmniRecordEntity>, kinds: OmniRelationKindContract);
+    createEntity(input: DeepPartial<OmniRelationEntity>, findOptions?: CrudGenFindManyOptions<OmniRelationEntity>, returnEntity?: true): Promise<OmniRelationEntity>;
+    createEntity(input: DeepPartial<OmniRelationEntity>, findOptions?: CrudGenFindManyOptions<OmniRelationEntity>, returnEntity?: boolean): Promise<OmniRelationEntity | boolean>;
+    updateEntity(conditions: FindOptionsWhere<OmniRelationEntity>, input: DeepPartial<OmniRelationEntity>, findOptions?: CrudGenFindManyOptions<OmniRelationEntity>, returnEntity?: true): Promise<OmniRelationEntity>;
+    updateEntity(conditions: FindOptionsWhere<OmniRelationEntity>, input: DeepPartial<OmniRelationEntity>, findOptions?: CrudGenFindManyOptions<OmniRelationEntity>, returnEntity?: boolean): Promise<OmniRelationEntity | boolean>;
+    protected assertRelation(input: DeepPartial<OmniRelationEntity>, recordRepository?: Repository<OmniRecordEntity>): Promise<void>;
+    protected assertEndpointKinds(_source: OmniRecordEntity, _target: OmniRecordEntity): void;
+    protected requiredIdentifier(value: unknown, field: string): string;
+}

package/src/omni-relation.service.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OmniRelationService = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("typeorm");
+const omni_relation_kind_contract_js_1 = require("./omni-relation-kind.contract.js");
+const omni_relation_semantics_js_1 = require("./omni-relation-semantics.js");
+const omni_scoped_service_js_1 = require("./omni-scoped.service.js");
+class OmniRelationService extends omni_scoped_service_js_1.OmniScopedService {
+    constructor(repository, scope, deletion, recordRepository, kinds) {
+        super(repository, scope, deletion);
+        this.recordRepository = recordRepository;
+        this.kinds = kinds;
+    }
+    async createEntity(input, findOptions, returnEntity = true) {
+        this.rejectServerFields(input);
+        await this.assertRelation(input);
+        return super.createEntity(input, findOptions, returnEntity);
+    }
+    async updateEntity(conditions, input, findOptions, returnEntity = true) {
+        for (const field of ['guid', 'sourceRecordId', 'targetRecordId']) {
+            if (Object.prototype.hasOwnProperty.call(input, field)) {
+                throw new common_1.BadRequestException(`Omni relation ${field} is immutable.`);
+            }
+        }
+        const current = await super.getEntity(conditions, undefined, undefined, undefined, {
+            failOnNull: true,
+        });
+        if (!current)
+            this.notFound();
+        await this.assertRelation({ ...current, ...input });
+        return super.updateEntity(conditions, input, findOptions, returnEntity);
+    }
+    async assertRelation(input, recordRepository = this.recordRepository) {
+        const sourceRecordId = this.requiredIdentifier(input.sourceRecordId, 'sourceRecordId');
+        const targetRecordId = this.requiredIdentifier(input.targetRecordId, 'targetRecordId');
+        const kind = this.requiredIdentifier(input.kind, 'kind');
+        try {
+            this.kinds.assert(kind);
+        }
+        catch (error) {
+            throw new common_1.BadRequestException(error instanceof Error
+                ? error.message
+                : 'Omni relation kind is invalid.');
+        }
+        const records = await recordRepository.find({
+            where: [
+                { scopeId: this.scopeId, guid: sourceRecordId, deletedAt: (0, typeorm_1.IsNull)() },
+                { scopeId: this.scopeId, guid: targetRecordId, deletedAt: (0, typeorm_1.IsNull)() },
+            ],
+        });
+        const source = records.find((record) => record.guid === sourceRecordId);
+        const target = records.find((record) => record.guid === targetRecordId);
+        if (!source || !target)
+            this.notFound();
+        this.assertEndpointKinds(source, target);
+        const isCanonical = omni_relation_kind_contract_js_1.canonicalOmniRelationKinds.includes(kind);
+        if (isCanonical &&
+            !(0, omni_relation_semantics_js_1.isAllowedOmniRelation)({
+                sourceKind: source.kind,
+                targetKind: target.kind,
+                relationKind: kind,
+            })) {
+            throw new common_1.BadRequestException('Omni relation kind is not valid for these endpoint kinds.');
+        }
+    }
+    assertEndpointKinds(_source, _target) { }
+    requiredIdentifier(value, field) {
+        if (typeof value !== 'string' || value.trim().length === 0) {
+            throw new common_1.BadRequestException(`Omni relation ${field} must be a non-empty string.`);
+        }
+        return value;
+    }
+}
+exports.OmniRelationService = OmniRelationService;
+//# sourceMappingURL=omni-relation.service.js.map

package/src/omni-relation.service.js.map

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