@nest-yalc-2/omnikernel-module 2.2.2 → 2.2.4

package/src/omni-record.service.ts

@@ -1,113 +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.',
-      );
-    }
-  }
-}
+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.ts

@@ -1,49 +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);
-    },
-  });
-}
+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);
+    },
+  });
+}

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

@@ -1,12 +1,12 @@
-import { registerEnumType } from '@nestjs/graphql';
-
-export enum OmniRelationKind {
-  Contains = 'contains',
-  References = 'references',
-  RelatedTo = 'related_to',
-  DerivedFrom = 'derived_from',
-}
-
-registerEnumType(OmniRelationKind, {
-  name: 'OmniRelationKind',
-});
+import { registerEnumType } from '@nestjs/graphql';
+
+export enum OmniRelationKind {
+  Contains = 'contains',
+  References = 'references',
+  RelatedTo = 'related_to',
+  DerivedFrom = 'derived_from',
+}
+
+registerEnumType(OmniRelationKind, {
+  name: 'OmniRelationKind',
+});