@nest-yalc-2/omnikernel-module 1.1.0

package/src/omni-external-ref.dto.js

@@ -0,0 +1,140 @@
+"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.OmniExternalRefUpdateInput = exports.OmniExternalRefCondition = exports.OmniExternalRefCreateInput = exports.OmniExternalRefType = 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_external_ref_entity_js_1 = require("./base/omni-external-ref.entity.js");
+const omni_dto_helpers_js_1 = require("./omni-dto.helpers.js");
+const omni_external_ref_internal_type_enum_js_1 = require("./omni-external-ref-internal-type.enum.js");
+let OmniExternalRefType = class OmniExternalRefType extends omni_external_ref_entity_js_1.OmniExternalRefEntity {
+    constructor(data) {
+        super();
+        if (data) {
+            (0, omni_dto_helpers_js_1.assignOmniPublicDto)(this, data);
+        }
+    }
+};
+exports.OmniExternalRefType = OmniExternalRefType;
+__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)
+], OmniExternalRefType.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)
+], OmniExternalRefType.prototype, "revision", void 0);
+__decorate([
+    (0, object_decorator_js_1.ModelField)({ gqlType: (0, returnValue_js_1.default)(omni_external_ref_internal_type_enum_js_1.OmniExternalRefInternalType) }),
+    (0, class_validator_1.IsEnum)(omni_external_ref_internal_type_enum_js_1.OmniExternalRefInternalType),
+    __metadata("design:type", String)
+], OmniExternalRefType.prototype, "internalType", 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)
+], OmniExternalRefType.prototype, "internalId", 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)(128),
+    __metadata("design:type", String)
+], OmniExternalRefType.prototype, "provider", 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)
+], OmniExternalRefType.prototype, "account", 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)
+], OmniExternalRefType.prototype, "container", 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)
+], OmniExternalRefType.prototype, "externalId", 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)
+], OmniExternalRefType.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)
+], OmniExternalRefType.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)
+], OmniExternalRefType.prototype, "payloadSchemaVersion", void 0);
+exports.OmniExternalRefType = OmniExternalRefType = __decorate([
+    (0, graphql_1.ObjectType)(),
+    (0, object_decorator_js_1.ModelObject)(),
+    __metadata("design:paramtypes", [Object])
+], OmniExternalRefType);
+let OmniExternalRefCreateInput = class OmniExternalRefCreateInput extends (0, graphql_1.OmitType)(OmniExternalRefType, ['createdAt', 'updatedAt', 'revision'], graphql_1.InputType) {
+};
+exports.OmniExternalRefCreateInput = OmniExternalRefCreateInput;
+exports.OmniExternalRefCreateInput = OmniExternalRefCreateInput = __decorate([
+    (0, graphql_1.InputType)(),
+    (0, object_decorator_js_1.ModelObject)()
+], OmniExternalRefCreateInput);
+let OmniExternalRefCondition = class OmniExternalRefCondition extends (0, graphql_1.PartialType)(OmniExternalRefCreateInput, graphql_1.InputType) {
+};
+exports.OmniExternalRefCondition = OmniExternalRefCondition;
+exports.OmniExternalRefCondition = OmniExternalRefCondition = __decorate([
+    (0, graphql_1.InputType)(),
+    (0, object_decorator_js_1.ModelObject)({ copyFrom: OmniExternalRefType })
+], OmniExternalRefCondition);
+let OmniExternalRefUpdateInput = class OmniExternalRefUpdateInput extends (0, graphql_1.PartialType)(OmniExternalRefCreateInput, graphql_1.InputType) {
+};
+exports.OmniExternalRefUpdateInput = OmniExternalRefUpdateInput;
+exports.OmniExternalRefUpdateInput = OmniExternalRefUpdateInput = __decorate([
+    (0, graphql_1.InputType)(),
+    (0, object_decorator_js_1.ModelObject)({ copyFrom: OmniExternalRefType })
+], OmniExternalRefUpdateInput);
+//# sourceMappingURL=omni-external-ref.dto.js.map

package/src/omni-external-ref.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omni-external-ref.dto.js","sourceRoot":"","sources":["omni-external-ref.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,6CAMyB;AACzB,mFAGmD;AACnD,gFAAyE;AACzE,uFAA4D;AAC5D,qDAQyB;AACzB,yDAAsD;AACtD,oFAA2E;AAC3E,+DAA4D;AAC5D,uGAAwF;AAIjF,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,mDAAqB;IAC5D,YAAY,IAAmC;QAC7C,KAAK,EAAE,CAAC;QACR,IAAI,IAAI,EAAE,CAAC;YACT,IAAA,yCAAmB,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;CAsEF,CAAA;AA5EY,kDAAmB;AAU9B;IAFC,IAAA,gCAAU,EAAC,EAAE,OAAO,EAAE,IAAA,wBAAW,EAAC,2BAAU,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAClE,IAAA,wBAAM,GAAE;;iDACK;AAId;IAFC,IAAA,gCAAU,EAAC,EAAE,OAAO,EAAE,IAAA,wBAAW,EAAC,aAAG,CAAC,EAAE,CAAC;IACzC,IAAA,uBAAK,GAAE;;qDACU;AAIlB;IAFC,IAAA,gCAAU,EAAC,EAAE,OAAO,EAAE,IAAA,wBAAW,EAAC,qEAA2B,CAAC,EAAE,CAAC;IACjE,IAAA,wBAAM,EAAC,qEAA2B,CAAC;;yDACO;AAI3C;IAFC,IAAA,gCAAU,EAAC,EAAE,OAAO,EAAE,IAAA,wBAAW,EAAC,2BAAU,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAClE,IAAA,wBAAM,GAAE;;uDACW;AAKpB;IAHC,IAAA,gCAAU,EAAC,EAAE,OAAO,EAAE,IAAA,wBAAW,EAAC,MAAM,CAAC,EAAE,CAAC;IAC5C,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;qDACG;AASlB;IAPC,IAAA,gCAAU,EAAC;QACV,OAAO,EAAE,IAAA,wBAAW,EAAC,MAAM,CAAC;QAC5B,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC/B,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;oDACS;AASxB;IAPC,IAAA,gCAAU,EAAC;QACV,OAAO,EAAE,IAAA,wBAAW,EAAC,MAAM,CAAC;QAC5B,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC/B,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;sDACW;AAK1B;IAHC,IAAA,gCAAU,EAAC,EAAE,OAAO,EAAE,IAAA,wBAAW,EAAC,MAAM,CAAC,EAAE,CAAC;IAC5C,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;uDACK;AAQpB;IANC,IAAA,gCAAU,EAAC;QACV,OAAO,EAAE,IAAA,wBAAW,EAAC,qCAAiB,CAAC;QACvC,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC/B,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;oDAC8B;AASzC;IAPC,IAAA,gCAAU,EAAC;QACV,OAAO,EAAE,IAAA,wBAAW,EAAC,MAAM,CAAC;QAC5B,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC/B,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;4DACiB;AAQhC;IANC,IAAA,gCAAU,EAAC;QACV,OAAO,EAAE,IAAA,wBAAW,EAAC,aAAG,CAAC;QACzB,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC/B,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,uBAAK,GAAE;;iEAC6B;8BA3E1B,mBAAmB;IAF/B,IAAA,oBAAU,GAAE;IACZ,IAAA,iCAAW,GAAE;;GACD,mBAAmB,CA4E/B;AAIM,IAAM,0BAA0B,GAAhC,MAAM,0BAA2B,SAAQ,IAAA,kBAAQ,EACtD,mBAAmB,EACnB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAU,EAC/C,mBAAS,CACV;CAAG,CAAA;AAJS,gEAA0B;qCAA1B,0BAA0B;IAFtC,IAAA,mBAAS,GAAE;IACX,IAAA,iCAAW,GAAE;GACD,0BAA0B,CAInC;AAIG,IAAM,wBAAwB,GAA9B,MAAM,wBAAyB,SAAQ,IAAA,qBAAW,EACvD,0BAA0B,EAC1B,mBAAS,CACV;CAAG,CAAA;AAHS,4DAAwB;mCAAxB,wBAAwB;IAFpC,IAAA,mBAAS,GAAE;IACX,IAAA,iCAAW,EAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;GAClC,wBAAwB,CAGjC;AAIG,IAAM,0BAA0B,GAAhC,MAAM,0BAA2B,SAAQ,IAAA,qBAAW,EACzD,0BAA0B,EAC1B,mBAAS,CACV;CAAG,CAAA;AAHS,gEAA0B;qCAA1B,0BAA0B;IAFtC,IAAA,mBAAS,GAAE;IACX,IAAA,iCAAW,EAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAC;GAClC,0BAA0B,CAGnC"}

package/src/omni-external-ref.dto.ts

@@ -0,0 +1,128 @@
+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 { OmniExternalRefEntity } from './base/omni-external-ref.entity.js';
+import { assignOmniPublicDto } from './omni-dto.helpers.js';
+import { OmniExternalRefInternalType } from './omni-external-ref-internal-type.enum.js';
+
+@ObjectType()
+@ModelObject()
+export class OmniExternalRefType extends OmniExternalRefEntity {
+  constructor(data?: Partial<OmniExternalRefType>) {
+    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(OmniExternalRefInternalType) })
+  @IsEnum(OmniExternalRefInternalType)
+  internalType!: OmniExternalRefInternalType;
+
+  @ModelField({ gqlType: returnValue(UUIDScalar), isRequired: true })
+  @IsUUID()
+  internalId!: string;
+
+  @ModelField({ gqlType: returnValue(String) })
+  @IsString()
+  @MaxLength(128)
+  provider!: string;
+
+  @ModelField({
+    gqlType: returnValue(String),
+    gqlOptions: { nullable: true },
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(128)
+  account?: string | null;
+
+  @ModelField({
+    gqlType: returnValue(String),
+    gqlOptions: { nullable: true },
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(128)
+  container?: string | null;
+
+  @ModelField({ gqlType: returnValue(String) })
+  @IsString()
+  @MaxLength(255)
+  externalId!: string;
+
+  @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;
+}
+
+@InputType()
+@ModelObject()
+export class OmniExternalRefCreateInput extends OmitType(
+  OmniExternalRefType,
+  ['createdAt', 'updatedAt', 'revision'] as const,
+  InputType,
+) {}
+
+@InputType()
+@ModelObject({ copyFrom: OmniExternalRefType })
+export class OmniExternalRefCondition extends PartialType(
+  OmniExternalRefCreateInput,
+  InputType,
+) {}
+
+@InputType()
+@ModelObject({ copyFrom: OmniExternalRefType })
+export class OmniExternalRefUpdateInput extends PartialType(
+  OmniExternalRefCreateInput,
+  InputType,
+) {}

package/src/omni-external-ref.service.d.ts

@@ -0,0 +1,33 @@
+import type { CrudGenFindManyOptions } from '@nest-yalc-2/crud-gen/api-graphql/crud-gen-gql.interface.js';
+import type { DeepPartial, FindOptionsWhere } from 'typeorm';
+import { OmniExternalRefEntity } from './base/omni-external-ref.entity.js';
+import { OmniExternalRefBindingValidator } from './omni-external-ref-binding.validator.js';
+import { OmniExternalRefInternalType } from './omni-external-ref-internal-type.enum.js';
+import { OmniScopedService } from './omni-scoped.service.js';
+import type { OmniDeletePolicy, OmniScope } from './omni-scope.js';
+export interface OmniExternalRefLookup {
+    provider: string;
+    externalId: string;
+    account?: string | null;
+    container?: string | null;
+}
+export interface OmniExternalRefSyncInput extends OmniExternalRefLookup {
+    payload?: Record<string, unknown> | null;
+}
+export type OmniExternalRefUpsertInput = Omit<DeepPartial<OmniExternalRefEntity>, 'provider' | 'externalId' | 'internalType' | 'internalId'> & Pick<OmniExternalRefEntity, 'provider' | 'externalId' | 'internalType' | 'internalId'>;
+export declare class OmniExternalRefService extends OmniScopedService<OmniExternalRefEntity> {
+    private readonly bindingValidator;
+    constructor(repository: any, scopeOrRepositoryWrite: OmniScope | any | undefined, deletion: OmniDeletePolicy, bindingValidator: OmniExternalRefBindingValidator);
+    findByExternalIdentity({ provider, externalId, account, container, }: OmniExternalRefLookup): Promise<OmniExternalRefEntity | null>;
+    findForInternalRecord(internalType: OmniExternalRefInternalType, internalId: string, provider?: string): Promise<OmniExternalRefEntity[]>;
+    upsertExternalRef(input: OmniExternalRefUpsertInput): Promise<OmniExternalRefEntity>;
+    syncDocumentReference(internalId: string, input: OmniExternalRefSyncInput): Promise<OmniExternalRefEntity>;
+    syncCollectionReference(internalId: string, input: OmniExternalRefSyncInput): Promise<OmniExternalRefEntity>;
+    createEntity(input: DeepPartial<OmniExternalRefEntity>, findOptions?: CrudGenFindManyOptions<OmniExternalRefEntity>, returnEntity?: true): Promise<OmniExternalRefEntity>;
+    createEntity(input: DeepPartial<OmniExternalRefEntity>, findOptions?: CrudGenFindManyOptions<OmniExternalRefEntity>, returnEntity?: boolean): Promise<OmniExternalRefEntity | boolean>;
+    updateEntity(conditions: FindOptionsWhere<OmniExternalRefEntity>, input: DeepPartial<OmniExternalRefEntity>, findOptions?: CrudGenFindManyOptions<OmniExternalRefEntity>, returnEntity?: true): Promise<OmniExternalRefEntity>;
+    updateEntity(conditions: FindOptionsWhere<OmniExternalRefEntity>, input: DeepPartial<OmniExternalRefEntity>, findOptions?: CrudGenFindManyOptions<OmniExternalRefEntity>, returnEntity?: boolean): Promise<OmniExternalRefEntity | boolean>;
+    private assertBinding;
+    private rejectBindingMutation;
+    private normalizeExternalIdentity;
+}

package/src/omni-external-ref.service.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OmniExternalRefService = void 0;
+const common_1 = require("@nestjs/common");
+const omni_external_ref_internal_type_enum_js_1 = require("./omni-external-ref-internal-type.enum.js");
+const omni_scoped_service_js_1 = require("./omni-scoped.service.js");
+function hasOwn(input, key) {
+    return Object.prototype.hasOwnProperty.call(input, key);
+}
+class OmniExternalRefService extends omni_scoped_service_js_1.OmniScopedService {
+    constructor(repository, scopeOrRepositoryWrite, deletion, bindingValidator) {
+        if (!bindingValidator) {
+            throw new TypeError('OmniExternalRefService requires an OmniExternalRefBindingValidator.');
+        }
+        super(repository, scopeOrRepositoryWrite, deletion);
+        this.bindingValidator = bindingValidator;
+    }
+    async findByExternalIdentity({ provider, externalId, account = null, container = null, }) {
+        return this.getRepository().findOne({
+            where: {
+                scopeId: this.scopeId,
+                provider,
+                externalId,
+                account: account ?? '',
+                container: container ?? '',
+            },
+        });
+    }
+    async findForInternalRecord(internalType, internalId, provider) {
+        return this.getRepository().find({
+            where: {
+                scopeId: this.scopeId,
+                internalType,
+                internalId,
+                ...(provider ? { provider } : {}),
+            },
+            order: {
+                createdAt: 'ASC',
+            },
+        });
+    }
+    async upsertExternalRef(input) {
+        if (input.provider.trim().length === 0) {
+            throw new Error('OmniExternalRef.provider is required');
+        }
+        if (input.externalId.trim().length === 0) {
+            throw new Error('OmniExternalRef.externalId is required');
+        }
+        const existing = await this.findByExternalIdentity({
+            provider: input.provider,
+            externalId: input.externalId,
+            account: input.account ?? null,
+            container: input.container ?? null,
+        });
+        if (existing) {
+            if (existing.internalType !== input.internalType ||
+                existing.internalId !== input.internalId) {
+                throw new common_1.ConflictException('External reference binding is immutable after creation.');
+            }
+            const { internalType: _internalType, internalId: _internalId, ...update } = this.normalizeExternalIdentity(input);
+            return this.updateEntity({ guid: existing.guid }, update);
+        }
+        return this.createEntity(this.normalizeExternalIdentity(input));
+    }
+    async syncDocumentReference(internalId, input) {
+        return this.upsertExternalRef({
+            ...input,
+            internalType: omni_external_ref_internal_type_enum_js_1.OmniExternalRefInternalType.Document,
+            internalId,
+        });
+    }
+    async syncCollectionReference(internalId, input) {
+        return this.upsertExternalRef({
+            ...input,
+            internalType: omni_external_ref_internal_type_enum_js_1.OmniExternalRefInternalType.Collection,
+            internalId,
+        });
+    }
+    async createEntity(input, findOptions, returnEntity = true) {
+        const normalized = this.normalizeExternalIdentity(input);
+        this.rejectServerFields(normalized);
+        await this.assertBinding(normalized);
+        if (typeof normalized.provider === 'string' &&
+            typeof normalized.externalId === 'string') {
+            const existing = await this.findByExternalIdentity({
+                provider: normalized.provider,
+                externalId: normalized.externalId,
+                account: normalized.account ?? null,
+                container: normalized.container ?? null,
+            });
+            if (existing) {
+                throw new common_1.ConflictException('External reference identity already exists in this scope.');
+            }
+        }
+        return super.createEntity(normalized, findOptions, returnEntity);
+    }
+    async updateEntity(conditions, input, findOptions, returnEntity = true) {
+        const normalized = this.normalizeExternalIdentity(input);
+        this.rejectBindingMutation(normalized);
+        return super.updateEntity(conditions, normalized, findOptions, returnEntity);
+    }
+    async assertBinding(input) {
+        if (typeof input.internalId !== 'string' ||
+            input.internalType === undefined) {
+            throw new common_1.ConflictException('External reference binding requires internalType and internalId.');
+        }
+        if (input.internalType !== omni_external_ref_internal_type_enum_js_1.OmniExternalRefInternalType.Record) {
+            return;
+        }
+        await this.bindingValidator.assertTarget({
+            internalId: input.internalId,
+            internalType: input.internalType,
+        });
+    }
+    rejectBindingMutation(input) {
+        if (hasOwn(input, 'internalType') || hasOwn(input, 'internalId')) {
+            throw new common_1.ConflictException('External reference binding is immutable after creation.');
+        }
+    }
+    normalizeExternalIdentity(input) {
+        return {
+            ...input,
+            ...(Object.prototype.hasOwnProperty.call(input, 'account')
+                ? { account: input.account ?? '' }
+                : {}),
+            ...(Object.prototype.hasOwnProperty.call(input, 'container')
+                ? { container: input.container ?? '' }
+                : {}),
+        };
+    }
+}
+exports.OmniExternalRefService = OmniExternalRefService;
+//# sourceMappingURL=omni-external-ref.service.js.map

package/src/omni-external-ref.service.js.map

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