@nest-yalc-2/omnikernel-module 1.1.0

package/src/omni-record.backend.ts

@@ -0,0 +1,19 @@
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+import { omniScopedBackendProvidersFactory } from './omni-scoped.backend.js';
+import { OmniRecordService } from './omni-record.service.js';
+
+export const omniRecordBackendProvidersFactory = (
+  dbConnection: string,
+  reservedRecordKinds: readonly string[] = [],
+) =>
+  omniScopedBackendProvidersFactory<OmniRecordEntity>({
+    entityModel: OmniRecordEntity,
+    dbConnection,
+    createService: (repository, scope, options) =>
+      new OmniRecordService(
+        repository,
+        scope,
+        options.deletion.record,
+        reservedRecordKinds,
+      ),
+  });

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

@@ -0,0 +1,29 @@
+import type { Relation } from 'typeorm';
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+import { OmniRelationType } from './omni-relation.dto.js';
+import { OmniRecordStatus } from './omni-record-status.enum.js';
+export declare class OmniRecordType extends OmniRecordEntity {
+    constructor(data?: Partial<OmniRecordType>);
+    guid: string;
+    revision: number;
+    externalId?: string | null;
+    title: string;
+    slug?: string | null;
+    kind: string;
+    status: OmniRecordStatus;
+    payload?: Record<string, unknown> | null;
+    payloadSchemaId?: string | null;
+    payloadSchemaVersion?: number | null;
+    outgoingRelations?: Relation<OmniRelationType[]>;
+    incomingRelations?: Relation<OmniRelationType[]>;
+}
+declare const OmniRecordCreateInput_base: import("@nestjs/common").Type<Omit<OmniRecordType, "revision" | "createdAt" | "updatedAt" | "outgoingRelations" | "incomingRelations">>;
+export declare class OmniRecordCreateInput extends OmniRecordCreateInput_base {
+}
+declare const OmniRecordCondition_base: import("@nestjs/common").Type<Partial<OmniRecordCreateInput>>;
+export declare class OmniRecordCondition extends OmniRecordCondition_base {
+}
+declare const OmniRecordUpdateInput_base: import("@nestjs/common").Type<Partial<OmniRecordCreateInput>>;
+export declare class OmniRecordUpdateInput extends OmniRecordUpdateInput_base {
+}
+export {};

package/src/omni-record.dto.js

@@ -0,0 +1,169 @@
+"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.OmniRecordUpdateInput = exports.OmniRecordCondition = exports.OmniRecordCreateInput = exports.OmniRecordType = 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_relation_dto_js_1 = require("./omni-relation.dto.js");
+const omni_record_status_enum_js_1 = require("./omni-record-status.enum.js");
+let OmniRecordType = class OmniRecordType extends omni_record_entity_js_1.OmniRecordEntity {
+    constructor(data) {
+        super();
+        if (data) {
+            (0, omni_dto_helpers_js_1.assignOmniPublicDto)(this, data);
+        }
+    }
+};
+exports.OmniRecordType = OmniRecordType;
+__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)
+], OmniRecordType.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)
+], OmniRecordType.prototype, "revision", 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)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", Object)
+], OmniRecordType.prototype, "externalId", 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.MaxLength)(255),
+    __metadata("design:type", String)
+], OmniRecordType.prototype, "title", 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)(),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", Object)
+], OmniRecordType.prototype, "slug", 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.MaxLength)(64),
+    __metadata("design:type", String)
+], OmniRecordType.prototype, "kind", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({ gqlType: (0, returnValue_js_1.default)(omni_record_status_enum_js_1.OmniRecordStatus) }),
+    (0, class_validator_1.IsEnum)(omni_record_status_enum_js_1.OmniRecordStatus),
+    __metadata("design:type", String)
+], OmniRecordType.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)
+], OmniRecordType.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)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", Object)
+], OmniRecordType.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)
+], OmniRecordType.prototype, "payloadSchemaVersion", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({
+        gqlType: () => [omni_relation_dto_js_1.OmniRelationType],
+        gqlOptions: { nullable: true },
+        relation: {
+            relationType: 'one-to-many',
+            sourceKey: { dst: 'guid', alias: 'guid' },
+            targetKey: { dst: 'sourceRecordId', alias: 'sourceRecordId' },
+            type: () => omni_relation_entity_js_1.OmniRelationEntity,
+        },
+    }),
+    __metadata("design:type", Object)
+], OmniRecordType.prototype, "outgoingRelations", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({
+        gqlType: () => [omni_relation_dto_js_1.OmniRelationType],
+        gqlOptions: { nullable: true },
+        relation: {
+            relationType: 'one-to-many',
+            sourceKey: { dst: 'guid', alias: 'guid' },
+            targetKey: { dst: 'targetRecordId', alias: 'targetRecordId' },
+            type: () => omni_relation_entity_js_1.OmniRelationEntity,
+        },
+    }),
+    __metadata("design:type", Object)
+], OmniRecordType.prototype, "incomingRelations", void 0);
+exports.OmniRecordType = OmniRecordType = __decorate([
+    (0, graphql_1.ObjectType)(),
+    (0, object_decorator_js_1.ModelObject)(),
+    __metadata("design:paramtypes", [Object])
+], OmniRecordType);
+let OmniRecordCreateInput = class OmniRecordCreateInput extends (0, graphql_1.OmitType)(OmniRecordType, [
+    'createdAt',
+    'updatedAt',
+    'revision',
+    'outgoingRelations',
+    'incomingRelations',
+], graphql_1.InputType) {
+};
+exports.OmniRecordCreateInput = OmniRecordCreateInput;
+exports.OmniRecordCreateInput = OmniRecordCreateInput = __decorate([
+    (0, graphql_1.InputType)(),
+    (0, object_decorator_js_1.ModelObject)()
+], OmniRecordCreateInput);
+let OmniRecordCondition = class OmniRecordCondition extends (0, graphql_1.PartialType)(OmniRecordCreateInput, graphql_1.InputType) {
+};
+exports.OmniRecordCondition = OmniRecordCondition;
+exports.OmniRecordCondition = OmniRecordCondition = __decorate([
+    (0, graphql_1.InputType)(),
+    (0, object_decorator_js_1.ModelObject)({ copyFrom: OmniRecordType })
+], OmniRecordCondition);
+let OmniRecordUpdateInput = class OmniRecordUpdateInput extends (0, graphql_1.PartialType)(OmniRecordCreateInput, graphql_1.InputType) {
+};
+exports.OmniRecordUpdateInput = OmniRecordUpdateInput;
+exports.OmniRecordUpdateInput = OmniRecordUpdateInput = __decorate([
+    (0, graphql_1.InputType)(),
+    (0, object_decorator_js_1.ModelObject)({ copyFrom: OmniRecordType })
+], OmniRecordUpdateInput);
+//# sourceMappingURL=omni-record.dto.js.map

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

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

package/src/omni-record.dto.ts

@@ -0,0 +1,157 @@
+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,
+  MaxLength,
+} 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 { OmniRelationType } from './omni-relation.dto.js';
+import { OmniRecordStatus } from './omni-record-status.enum.js';
+
+@ObjectType()
+@ModelObject()
+export class OmniRecordType extends OmniRecordEntity {
+  constructor(data?: Partial<OmniRecordType>) {
+    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(String),
+    gqlOptions: { nullable: true },
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(128)
+  externalId?: string | null;
+
+  @ModelField({ gqlType: returnValue(String) })
+  @IsString()
+  @MaxLength(255)
+  title!: string;
+
+  @ModelField({
+    gqlType: returnValue(String),
+    gqlOptions: { nullable: true },
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(255)
+  slug?: string | null;
+
+  @ModelField({ gqlType: returnValue(String) })
+  @IsString()
+  @MaxLength(64)
+  kind!: string;
+
+  @ModelField({ gqlType: returnValue(OmniRecordStatus) })
+  @IsEnum(OmniRecordStatus)
+  status!: OmniRecordStatus;
+
+  @ModelField({
+    gqlType: returnValue(GraphQLJSONObject),
+    gqlOptions: { nullable: true },
+  })
+  @IsOptional()
+  @IsObject()
+  payload?: Record<string, unknown> | null;
+
+  @ModelField({
+    gqlType: returnValue(String),
+    gqlOptions: { nullable: true },
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(128)
+  payloadSchemaId?: string | null;
+
+  @ModelField({
+    gqlType: returnValue(Int),
+    gqlOptions: { nullable: true },
+  })
+  @IsOptional()
+  @IsInt()
+  payloadSchemaVersion?: number | null;
+
+  @ModelField({
+    gqlType: () => [OmniRelationType],
+    gqlOptions: { nullable: true },
+    relation: {
+      relationType: 'one-to-many',
+      sourceKey: { dst: 'guid', alias: 'guid' },
+      targetKey: { dst: 'sourceRecordId', alias: 'sourceRecordId' },
+      type: () => OmniRelationEntity,
+    },
+  })
+  outgoingRelations?: Relation<OmniRelationType[]>;
+
+  @ModelField({
+    gqlType: () => [OmniRelationType],
+    gqlOptions: { nullable: true },
+    relation: {
+      relationType: 'one-to-many',
+      sourceKey: { dst: 'guid', alias: 'guid' },
+      targetKey: { dst: 'targetRecordId', alias: 'targetRecordId' },
+      type: () => OmniRelationEntity,
+    },
+  })
+  incomingRelations?: Relation<OmniRelationType[]>;
+}
+
+@InputType()
+@ModelObject()
+export class OmniRecordCreateInput extends OmitType(
+  OmniRecordType,
+  [
+    'createdAt',
+    'updatedAt',
+    'revision',
+    'outgoingRelations',
+    'incomingRelations',
+  ] as const,
+  InputType,
+) {}
+
+@InputType()
+@ModelObject({ copyFrom: OmniRecordType })
+export class OmniRecordCondition extends PartialType(
+  OmniRecordCreateInput,
+  InputType,
+) {}
+
+@InputType()
+@ModelObject({ copyFrom: OmniRecordType })
+export class OmniRecordUpdateInput extends PartialType(
+  OmniRecordCreateInput,
+  InputType,
+) {}

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

@@ -0,0 +1,18 @@
+import type { CrudGenFindManyOptions } from '@nest-yalc-2/crud-gen/api-graphql/crud-gen-gql.interface.js';
+import type { GenericTypeORMRepository } from '@nest-yalc-2/crud-gen/typeorm/generic.repository.js';
+import { type DeepPartial, type FindOptionsWhere } from 'typeorm';
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+import type { OmniDeletePolicy, OmniScope } from './omni-scope.js';
+import { OmniScopedService } from './omni-scoped.service.js';
+export declare class OmniRecordService extends OmniScopedService<OmniRecordEntity> {
+    private readonly reservedKinds;
+    constructor(repository: GenericTypeORMRepository<OmniRecordEntity>, scopeOrRepositoryWrite?: OmniScope | GenericTypeORMRepository<OmniRecordEntity>, deletion?: OmniDeletePolicy, reservedRecordKinds?: readonly string[]);
+    createEntity(input: DeepPartial<OmniRecordEntity>, findOptions?: CrudGenFindManyOptions<OmniRecordEntity>, returnEntity?: true): Promise<OmniRecordEntity>;
+    createEntity(input: DeepPartial<OmniRecordEntity>, findOptions?: CrudGenFindManyOptions<OmniRecordEntity>, returnEntity?: boolean): Promise<OmniRecordEntity | boolean>;
+    updateEntity(conditions: FindOptionsWhere<OmniRecordEntity>, input: DeepPartial<OmniRecordEntity>, findOptions?: CrudGenFindManyOptions<OmniRecordEntity>, returnEntity?: true): Promise<OmniRecordEntity>;
+    updateEntity(conditions: FindOptionsWhere<OmniRecordEntity>, input: DeepPartial<OmniRecordEntity>, findOptions?: CrudGenFindManyOptions<OmniRecordEntity>, returnEntity?: boolean): Promise<OmniRecordEntity | boolean>;
+    deleteEntity(conditions: FindOptionsWhere<OmniRecordEntity>): Promise<boolean>;
+    private assertExistingRecordIsNotReserved;
+    private nonReservedConditions;
+    private rejectReservedKind;
+}

package/src/omni-record.service.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OmniRecordService = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("typeorm");
+const omni_scoped_service_js_1 = require("./omni-scoped.service.js");
+class OmniRecordService extends omni_scoped_service_js_1.OmniScopedService {
+    constructor(repository, scopeOrRepositoryWrite, deletion = 'tombstone', reservedRecordKinds = []) {
+        super(repository, scopeOrRepositoryWrite, deletion);
+        this.reservedKinds = new Set(reservedRecordKinds);
+    }
+    async createEntity(input, findOptions, returnEntity = true) {
+        this.rejectReservedKind(input.kind);
+        return super.createEntity(input, findOptions, returnEntity);
+    }
+    async updateEntity(conditions, input, findOptions, returnEntity = true) {
+        this.rejectReservedKind(input.kind);
+        await this.assertExistingRecordIsNotReserved(conditions);
+        return super.updateEntity(this.nonReservedConditions(conditions), input, findOptions, returnEntity);
+    }
+    async deleteEntity(conditions) {
+        await this.assertExistingRecordIsNotReserved(conditions);
+        return super.deleteEntity(this.nonReservedConditions(conditions));
+    }
+    async assertExistingRecordIsNotReserved(conditions) {
+        const record = await super.getEntity(conditions, undefined, undefined, undefined, { failOnNull: false });
+        if (record)
+            this.rejectReservedKind(record.kind);
+    }
+    nonReservedConditions(conditions) {
+        if (this.reservedKinds.size === 0)
+            return conditions;
+        return {
+            ...conditions,
+            kind: (0, typeorm_1.Not)((0, typeorm_1.In)([...this.reservedKinds])),
+        };
+    }
+    rejectReservedKind(kind) {
+        if (typeof kind === 'string' && this.reservedKinds.has(kind)) {
+            throw new common_1.BadRequestException('This record kind is owned by a registered extension projection.');
+        }
+    }
+}
+exports.OmniRecordService = OmniRecordService;
+//# sourceMappingURL=omni-record.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"omni-record.service.js","sourceRoot":"","sources":["omni-record.service.ts"],"names":[],"mappings":";;;AAAA,2CAAqD;AAGrD,qCAA2E;AAG3E,qEAA6D;AAQ7D,MAAa,iBAAkB,SAAQ,0CAAmC;IAGxE,YACE,UAAsD,EACtD,sBACwD,EACxD,WAA6B,WAAW,EACxC,sBAAyC,EAAE;QAE3C,KAAK,CAAC,UAAU,EAAE,sBAAsB,EAAE,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACpD,CAAC;IAYQ,KAAK,CAAC,YAAY,CACzB,KAAoC,EACpC,WAAsD,EACtD,YAAY,GAAG,IAAI;QAEnB,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAC9D,CAAC;IAcQ,KAAK,CAAC,YAAY,CACzB,UAA8C,EAC9C,KAAoC,EACpC,WAAsD,EACtD,YAAY,GAAG,IAAI;QAEnB,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,IAAI,CAAC,iCAAiC,CAAC,UAAU,CAAC,CAAC;QACzD,OAAO,KAAK,CAAC,YAAY,CACvB,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,EACtC,KAAK,EACL,WAAW,EACX,YAAY,CACb,CAAC;IACJ,CAAC;IAEQ,KAAK,CAAC,YAAY,CACzB,UAA8C;QAE9C,MAAM,IAAI,CAAC,iCAAiC,CAAC,UAAU,CAAC,CAAC;QACzD,OAAO,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC;IACpE,CAAC;IAEO,KAAK,CAAC,iCAAiC,CAC7C,UAA8C;QAE9C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAClC,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,EAAE,UAAU,EAAE,KAAK,EAAE,CACtB,CAAC;QACF,IAAI,MAAM;YAAE,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAEO,qBAAqB,CAC3B,UAA8C;QAE9C,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC;QACrD,OAAO;YACL,GAAG,UAAU;YACb,IAAI,EAAE,IAAA,aAAG,EAAC,IAAA,YAAE,EAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;SACvC,CAAC;IACJ,CAAC;IAEO,kBAAkB,CAAC,IAAa;QACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,4BAAmB,CAC3B,iEAAiE,CAClE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAlGD,8CAkGC"}

package/src/omni-record.service.ts

@@ -0,0 +1,113 @@
+import { BadRequestException } from '@nestjs/common';
+import type { CrudGenFindManyOptions } from '@nest-yalc-2/crud-gen/api-graphql/crud-gen-gql.interface.js';
+import type { GenericTypeORMRepository } from '@nest-yalc-2/crud-gen/typeorm/generic.repository.js';
+import { In, Not, type DeepPartial, type FindOptionsWhere } from 'typeorm';
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+import type { OmniDeletePolicy, OmniScope } from './omni-scope.js';
+import { OmniScopedService } from './omni-scoped.service.js';
+
+/**
+ * Raw Omni record CRUD with a mechanical boundary around extension-owned
+ * kinds. A registered extension is the only writer for its owner lifecycle;
+ * mounting a generic record transport cannot turn another record into that
+ * kind or mutate/delete an existing owner.
+ */
+export class OmniRecordService extends OmniScopedService<OmniRecordEntity> {
+  private readonly reservedKinds: ReadonlySet<string>;
+
+  constructor(
+    repository: GenericTypeORMRepository<OmniRecordEntity>,
+    scopeOrRepositoryWrite?:
+      OmniScope | GenericTypeORMRepository<OmniRecordEntity>,
+    deletion: OmniDeletePolicy = 'tombstone',
+    reservedRecordKinds: readonly string[] = [],
+  ) {
+    super(repository, scopeOrRepositoryWrite, deletion);
+    this.reservedKinds = new Set(reservedRecordKinds);
+  }
+
+  override async createEntity(
+    input: DeepPartial<OmniRecordEntity>,
+    findOptions?: CrudGenFindManyOptions<OmniRecordEntity>,
+    returnEntity?: true,
+  ): Promise<OmniRecordEntity>;
+  override async createEntity(
+    input: DeepPartial<OmniRecordEntity>,
+    findOptions?: CrudGenFindManyOptions<OmniRecordEntity>,
+    returnEntity?: boolean,
+  ): Promise<OmniRecordEntity | boolean>;
+  override async createEntity(
+    input: DeepPartial<OmniRecordEntity>,
+    findOptions?: CrudGenFindManyOptions<OmniRecordEntity>,
+    returnEntity = true,
+  ): Promise<OmniRecordEntity | boolean> {
+    this.rejectReservedKind(input.kind);
+    return super.createEntity(input, findOptions, returnEntity);
+  }
+
+  override async updateEntity(
+    conditions: FindOptionsWhere<OmniRecordEntity>,
+    input: DeepPartial<OmniRecordEntity>,
+    findOptions?: CrudGenFindManyOptions<OmniRecordEntity>,
+    returnEntity?: true,
+  ): Promise<OmniRecordEntity>;
+  override async updateEntity(
+    conditions: FindOptionsWhere<OmniRecordEntity>,
+    input: DeepPartial<OmniRecordEntity>,
+    findOptions?: CrudGenFindManyOptions<OmniRecordEntity>,
+    returnEntity?: boolean,
+  ): Promise<OmniRecordEntity | boolean>;
+  override async updateEntity(
+    conditions: FindOptionsWhere<OmniRecordEntity>,
+    input: DeepPartial<OmniRecordEntity>,
+    findOptions?: CrudGenFindManyOptions<OmniRecordEntity>,
+    returnEntity = true,
+  ): Promise<OmniRecordEntity | boolean> {
+    this.rejectReservedKind(input.kind);
+    await this.assertExistingRecordIsNotReserved(conditions);
+    return super.updateEntity(
+      this.nonReservedConditions(conditions),
+      input,
+      findOptions,
+      returnEntity,
+    );
+  }
+
+  override async deleteEntity(
+    conditions: FindOptionsWhere<OmniRecordEntity>,
+  ): Promise<boolean> {
+    await this.assertExistingRecordIsNotReserved(conditions);
+    return super.deleteEntity(this.nonReservedConditions(conditions));
+  }
+
+  private async assertExistingRecordIsNotReserved(
+    conditions: FindOptionsWhere<OmniRecordEntity>,
+  ): Promise<void> {
+    const record = await super.getEntity(
+      conditions,
+      undefined,
+      undefined,
+      undefined,
+      { failOnNull: false },
+    );
+    if (record) this.rejectReservedKind(record.kind);
+  }
+
+  private nonReservedConditions(
+    conditions: FindOptionsWhere<OmniRecordEntity>,
+  ): FindOptionsWhere<OmniRecordEntity> {
+    if (this.reservedKinds.size === 0) return conditions;
+    return {
+      ...conditions,
+      kind: Not(In([...this.reservedKinds])),
+    };
+  }
+
+  private rejectReservedKind(kind: unknown): void {
+    if (typeof kind === 'string' && this.reservedKinds.has(kind)) {
+      throw new BadRequestException(
+        'This record kind is owned by a registered extension projection.',
+      );
+    }
+  }
+}

package/src/omni-relation-kind.contract.d.ts

@@ -0,0 +1,9 @@
+import { OmniRelationKind } from './omni-relation-kind.enum.js';
+export declare const omniRelationKindPattern: RegExp;
+export declare const canonicalOmniRelationKinds: readonly [OmniRelationKind.Contains, OmniRelationKind.References, OmniRelationKind.RelatedTo, OmniRelationKind.DerivedFrom];
+export interface OmniRelationKindContract {
+    readonly kinds: ReadonlySet<string>;
+    assert(kind: unknown): asserts kind is string;
+    has(kind: string): boolean;
+}
+export declare function createOmniRelationKindContract(additionalKinds?: readonly string[]): OmniRelationKindContract;

package/src/omni-relation-kind.contract.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canonicalOmniRelationKinds = exports.omniRelationKindPattern = void 0;
+exports.createOmniRelationKindContract = createOmniRelationKindContract;
+const omni_relation_kind_enum_js_1 = require("./omni-relation-kind.enum.js");
+exports.omniRelationKindPattern = /^[a-z][a-z0-9_]{0,63}$/;
+exports.canonicalOmniRelationKinds = Object.freeze([
+    omni_relation_kind_enum_js_1.OmniRelationKind.Contains,
+    omni_relation_kind_enum_js_1.OmniRelationKind.References,
+    omni_relation_kind_enum_js_1.OmniRelationKind.RelatedTo,
+    omni_relation_kind_enum_js_1.OmniRelationKind.DerivedFrom,
+]);
+function createOmniRelationKindContract(additionalKinds = []) {
+    const kinds = new Set(exports.canonicalOmniRelationKinds);
+    for (const kind of additionalKinds) {
+        if (typeof kind !== 'string' || !exports.omniRelationKindPattern.test(kind)) {
+            throw new TypeError('Omni relation kinds must use lowercase letters, digits, and underscores.');
+        }
+        kinds.add(kind);
+    }
+    return Object.freeze({
+        kinds,
+        assert(kind) {
+            if (typeof kind !== 'string' || !kinds.has(kind)) {
+                throw new TypeError('Omni relation kind is not registered for this module.');
+            }
+        },
+        has(kind) {
+            return kinds.has(kind);
+        },
+    });
+}
+//# sourceMappingURL=omni-relation-kind.contract.js.map

package/src/omni-relation-kind.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omni-relation-kind.contract.js","sourceRoot":"","sources":["omni-relation-kind.contract.ts"],"names":[],"mappings":";;;AAsBA,wEA0BC;AAhDD,6EAAgE;AAEnD,QAAA,uBAAuB,GAAG,wBAAwB,CAAC;AAEnD,QAAA,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC;IACtD,6CAAgB,CAAC,QAAQ;IACzB,6CAAgB,CAAC,UAAU;IAC3B,6CAAgB,CAAC,SAAS;IAC1B,6CAAgB,CAAC,WAAW;CACpB,CAAC,CAAC;AAaZ,SAAgB,8BAA8B,CAC5C,kBAAqC,EAAE;IAEvC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAS,kCAA0B,CAAC,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,+BAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,SAAS,CACjB,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK;QACL,MAAM,CAAC,IAAa;YAClB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,SAAS,CACjB,uDAAuD,CACxD,CAAC;YACJ,CAAC;QACH,CAAC;QACD,GAAG,CAAC,IAAY;YACd,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/src/omni-relation-kind.contract.ts

@@ -0,0 +1,49 @@
+import { OmniRelationKind } from './omni-relation-kind.enum.js';
+
+export const omniRelationKindPattern = /^[a-z][a-z0-9_]{0,63}$/;
+
+export const canonicalOmniRelationKinds = Object.freeze([
+  OmniRelationKind.Contains,
+  OmniRelationKind.References,
+  OmniRelationKind.RelatedTo,
+  OmniRelationKind.DerivedFrom,
+] as const);
+
+export interface OmniRelationKindContract {
+  readonly kinds: ReadonlySet<string>;
+  assert(kind: unknown): asserts kind is string;
+  has(kind: string): boolean;
+}
+
+/**
+ * Canonical kinds are stable exports. Applications may register additional
+ * syntactically portable kinds at module composition time without changing
+ * OmniKernel or turning arbitrary strings into valid graph semantics.
+ */
+export function createOmniRelationKindContract(
+  additionalKinds: readonly string[] = [],
+): OmniRelationKindContract {
+  const kinds = new Set<string>(canonicalOmniRelationKinds);
+  for (const kind of additionalKinds) {
+    if (typeof kind !== 'string' || !omniRelationKindPattern.test(kind)) {
+      throw new TypeError(
+        'Omni relation kinds must use lowercase letters, digits, and underscores.',
+      );
+    }
+    kinds.add(kind);
+  }
+
+  return Object.freeze({
+    kinds,
+    assert(kind: unknown): asserts kind is string {
+      if (typeof kind !== 'string' || !kinds.has(kind)) {
+        throw new TypeError(
+          'Omni relation kind is not registered for this module.',
+        );
+      }
+    },
+    has(kind: string): boolean {
+      return kinds.has(kind);
+    },
+  });
+}