@nest-yalc-2/omnikernel-module 1.1.0

package/src/omni-projection.catalog.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OMNI_PROJECTION_READER_CATALOG = void 0;
+exports.createOmniProjectionReaderCatalog = createOmniProjectionReaderCatalog;
+exports.createOmniProjectionReaderCatalogProvider = createOmniProjectionReaderCatalogProvider;
+const crud_gen_1 = require("@nest-yalc-2/crud-gen");
+const typeorm_1 = require("typeorm");
+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_relation_projection_definition_js_1 = require("./omni-relation-projection.definition.js");
+const omni_relation_status_enum_js_1 = require("./omni-relation-status.enum.js");
+exports.OMNI_PROJECTION_READER_CATALOG = Symbol('OMNI_PROJECTION_READER_CATALOG');
+function freeze(value) {
+    if (value && typeof value === 'object')
+        Object.freeze(value);
+    return value;
+}
+function validateReaderTake(take) {
+    if (take === undefined)
+        return undefined;
+    if (!Number.isInteger(take) || take < 1 || take > 1_000) {
+        throw new TypeError('Omni projection reader take must be an integer from 1 to 1000.');
+    }
+    return take;
+}
+function relationWhere(definition) {
+    const relation = definition.relation;
+    return {
+        kind: (0, typeorm_1.In)([...(0, omni_relation_projection_definition_js_1.getOmniRelationProjectionAllowedKinds)(definition)]),
+        status: relation.status ?? omni_relation_status_enum_js_1.OmniRelationStatus.Active,
+        ...(relation.schema
+            ? {
+                payloadSchemaId: relation.schema.id,
+                payloadSchemaVersion: relation.schema.version,
+            }
+            : {
+                payloadSchemaId: (0, typeorm_1.IsNull)(),
+                payloadSchemaVersion: (0, typeorm_1.IsNull)(),
+            }),
+    };
+}
+function extensionReader(manager, scope, registration) {
+    const ownerWhere = {
+        scopeId: scope.scopeId,
+        kind: registration.definition.owner.kind,
+        payloadSchemaId: registration.definition.owner.schema.id,
+        payloadSchemaVersion: registration.definition.owner.schema.version,
+        deletedAt: (0, typeorm_1.IsNull)(),
+    };
+    const extensionRepository = manager.getRepository(registration.entity);
+    const ownerRepository = manager.getRepository(omni_record_entity_js_1.OmniRecordEntity);
+    const identity = registration.definition.identity.column;
+    const scopeColumn = registration.definition.scope.column;
+    const project = (entity, owner) => {
+        const projected = {
+            ...entity,
+            scopeId: owner.scopeId,
+            guid: owner.guid,
+            [registration.definition.revision.column]: owner.revision,
+            createdAt: owner.createdAt,
+            updatedAt: owner.updatedAt,
+            deletedAt: owner.deletedAt,
+        };
+        return projected;
+    };
+    const getOwner = async (guid) => {
+        const owner = await ownerRepository.findOne({
+            where: { ...ownerWhere, guid },
+        });
+        return owner ?? undefined;
+    };
+    const dialect = (() => {
+        const type = manager.connection.options.type;
+        if (type !== 'sqlite' && type !== 'postgres') {
+            throw new TypeError('Omni projection readers require SQLite or PostgreSQL.');
+        }
+        return (0, crud_gen_1.createProjectionDialect)(type);
+    })();
+    const filtersFor = (where) => {
+        const filters = [];
+        for (const [fieldName, value] of Object.entries(where ?? {})) {
+            const field = registration.definition.fields.find((candidate) => candidate.name === fieldName);
+            if (!field || !field.query?.filter?.includes('eq')) {
+                throw new TypeError(`Omni extension reader only permits declared eq fields: ${fieldName}.`);
+            }
+            filters.push({ field, operator: 'eq', values: [value] });
+        }
+        return filters;
+    };
+    const projectMany = async (entities) => {
+        if (entities.length === 0)
+            return [];
+        const candidates = entities.map((entity) => entity[identity]);
+        const guids = candidates.filter((guid) => typeof guid === 'string');
+        const owners = await ownerRepository.find({
+            where: { ...ownerWhere, guid: (0, typeorm_1.In)(guids) },
+        });
+        const ownersByGuid = new Map(owners.map((owner) => [owner.guid, owner]));
+        return entities.flatMap((entity) => {
+            const guid = entity[identity];
+            const owner = typeof guid === 'string' ? ownersByGuid.get(guid) : undefined;
+            return owner ? [project(entity, owner)] : [];
+        });
+    };
+    return freeze({
+        async get(guid) {
+            const entity = await extensionRepository.findOne({
+                where: { [scopeColumn]: scope.scopeId, [identity]: guid },
+            });
+            if (!entity)
+                return undefined;
+            const owner = await getOwner(guid);
+            return owner ? project(entity, owner) : undefined;
+        },
+        async list(options = {}) {
+            const [entities] = await dialect.findMany(extensionRepository, registration.definition, scope.scopeId, filtersFor(options.where), [], { take: validateReaderTake(options.take) });
+            return projectMany(entities);
+        },
+    });
+}
+function relationReader(manager, scope, registration) {
+    const repository = manager.getRepository(omni_relation_entity_js_1.OmniRelationEntity);
+    const fixed = relationWhere(registration.definition);
+    return freeze({
+        async get(guid) {
+            const entity = await repository.findOne({
+                where: { scopeId: scope.scopeId, guid, ...fixed },
+            });
+            return entity ?? undefined;
+        },
+        async list(options = {}) {
+            const { take, ...conditions } = options;
+            return await repository.find({
+                where: { scopeId: scope.scopeId, ...fixed, ...conditions },
+                take: validateReaderTake(take),
+            });
+        },
+    });
+}
+function createOmniProjectionReaderCatalog(registrations) {
+    const byId = new Map();
+    for (const source of registrations) {
+        const registration = 'reader' in source ? source.reader : source;
+        if (!registration.id || byId.has(registration.id)) {
+            throw new TypeError('Omni projection reader registrations must have unique non-empty ids.');
+        }
+        byId.set(registration.id, registration);
+    }
+    const snapshot = freeze(new Map(byId));
+    return freeze({
+        bind(manager, scope) {
+            return freeze({
+                extension(id) {
+                    const registration = snapshot.get(id);
+                    if (!registration || registration.type !== 'extension') {
+                        throw new TypeError(`Omni extension projection reader is not registered: ${id}.`);
+                    }
+                    return extensionReader(manager, scope, registration);
+                },
+                relation(id) {
+                    const registration = snapshot.get(id);
+                    if (!registration || registration.type !== 'relation') {
+                        throw new TypeError(`Omni relation projection reader is not registered: ${id}.`);
+                    }
+                    return relationReader(manager, scope, registration);
+                },
+            });
+        },
+    });
+}
+function createOmniProjectionReaderCatalogProvider(registrations, token = exports.OMNI_PROJECTION_READER_CATALOG) {
+    return {
+        provide: token,
+        useValue: createOmniProjectionReaderCatalog(registrations),
+    };
+}
+//# sourceMappingURL=omni-projection.catalog.js.map

package/src/omni-projection.catalog.js.map

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

package/src/omni-projection.catalog.ts

@@ -0,0 +1,345 @@
+import {
+  createProjectionDialect,
+  type ProjectionFilter,
+} from '@nest-yalc-2/crud-gen';
+import type { InjectionToken, Provider } from '@nestjs/common';
+import {
+  In,
+  IsNull,
+  type EntityManager,
+  type EntityTarget,
+  type ObjectLiteral,
+} from 'typeorm';
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+import { OmniRelationEntity } from './base/omni-relation.entity.js';
+import type { OmniExtensionProjectionDefinition } from './omni-extension-projection.definition.js';
+import {
+  getOmniRelationProjectionAllowedKinds,
+  type OmniRelationProjectionDefinition,
+} from './omni-relation-projection.definition.js';
+import { OmniRelationStatus } from './omni-relation-status.enum.js';
+import type { OmniScope } from './omni-scope.js';
+
+export interface OmniExtensionProjectionReaderRegistration<
+  Entity extends ObjectLiteral = ObjectLiteral,
+> {
+  readonly type: 'extension';
+  readonly id: string;
+  readonly entity: EntityTarget<Entity>;
+  readonly definition: OmniExtensionProjectionDefinition;
+}
+
+export interface OmniRelationProjectionReaderRegistration {
+  readonly type: 'relation';
+  readonly id: string;
+  readonly definition: OmniRelationProjectionDefinition;
+}
+
+export type OmniProjectionReaderRegistration =
+  | OmniExtensionProjectionReaderRegistration
+  | OmniRelationProjectionReaderRegistration;
+
+export interface OmniExtensionProjectionReader<
+  Entity extends ObjectLiteral = ObjectLiteral,
+> {
+  get(guid: string): Promise<Entity | undefined>;
+  list(options?: {
+    /** Equality only, on declared fields that explicitly allow eq filtering. */
+    where?: Readonly<Record<string, unknown>>;
+    /** A bounded result size; policies commonly use take: 1 for existence. */
+    take?: number;
+  }): Promise<Entity[]>;
+}
+
+export interface OmniRelationProjectionReader {
+  get(guid: string): Promise<OmniRelationEntity | undefined>;
+  list(options?: {
+    sourceRecordId?: string;
+    targetRecordId?: string;
+    /** A bounded result size for edge-existence checks. */
+    take?: number;
+  }): Promise<OmniRelationEntity[]>;
+}
+
+/**
+ * Manager-bound readers available to a lifecycle policy. They intentionally
+ * expose projection identities and constrained graph records, never TypeORM
+ * repositories or query runners.
+ */
+export interface OmniProjectionTransactionReaders {
+  extension<Entity extends ObjectLiteral = ObjectLiteral>(
+    id: string,
+  ): OmniExtensionProjectionReader<Entity>;
+  relation(id: string): OmniRelationProjectionReader;
+}
+
+export interface OmniProjectionReaderCatalog {
+  bind(
+    manager: EntityManager,
+    scope: OmniScope,
+  ): OmniProjectionTransactionReaders;
+}
+
+export interface OmniProjectionReaderCatalogProvider {
+  readonly token: InjectionToken<OmniProjectionReaderCatalog>;
+}
+
+export interface OmniProjectionReaderCatalogSource {
+  readonly reader: OmniProjectionReaderRegistration;
+}
+
+/** Default token for a composed set of generated Omni projection resources. */
+export const OMNI_PROJECTION_READER_CATALOG = Symbol(
+  'OMNI_PROJECTION_READER_CATALOG',
+);
+
+function freeze<T>(value: T): Readonly<T> {
+  if (value && typeof value === 'object') Object.freeze(value);
+  return value;
+}
+
+function validateReaderTake(take: number | undefined): number | undefined {
+  if (take === undefined) return undefined;
+  if (!Number.isInteger(take) || take < 1 || take > 1_000) {
+    throw new TypeError(
+      'Omni projection reader take must be an integer from 1 to 1000.',
+    );
+  }
+  return take;
+}
+
+function relationWhere(
+  definition: OmniRelationProjectionDefinition,
+): Record<string, unknown> {
+  const relation = definition.relation;
+  return {
+    kind: In([...getOmniRelationProjectionAllowedKinds(definition)]),
+    status: relation.status ?? OmniRelationStatus.Active,
+    ...(relation.schema
+      ? {
+          payloadSchemaId: relation.schema.id,
+          payloadSchemaVersion: relation.schema.version,
+        }
+      : {
+          payloadSchemaId: IsNull(),
+          payloadSchemaVersion: IsNull(),
+        }),
+  };
+}
+
+function extensionReader<Entity extends ObjectLiteral>(
+  manager: EntityManager,
+  scope: OmniScope,
+  registration: OmniExtensionProjectionReaderRegistration<Entity>,
+): OmniExtensionProjectionReader<Entity> {
+  const ownerWhere = {
+    scopeId: scope.scopeId,
+    kind: registration.definition.owner.kind,
+    payloadSchemaId: registration.definition.owner.schema.id,
+    payloadSchemaVersion: registration.definition.owner.schema.version,
+    deletedAt: IsNull(),
+  };
+  const extensionRepository = manager.getRepository(registration.entity);
+  const ownerRepository = manager.getRepository(OmniRecordEntity);
+  const identity = registration.definition.identity.column;
+  const scopeColumn = registration.definition.scope.column;
+
+  const project = (entity: Entity, owner: OmniRecordEntity): Entity => {
+    const projected = {
+      ...entity,
+      scopeId: owner.scopeId,
+      guid: owner.guid,
+      [registration.definition.revision.column]: owner.revision,
+      createdAt: owner.createdAt,
+      updatedAt: owner.updatedAt,
+      deletedAt: owner.deletedAt,
+    } as Entity;
+    return projected;
+  };
+
+  const getOwner = async (
+    guid: string,
+  ): Promise<OmniRecordEntity | undefined> => {
+    const owner = await ownerRepository.findOne({
+      where: { ...ownerWhere, guid },
+    });
+    return owner ?? undefined;
+  };
+
+  const dialect = (() => {
+    const type = manager.connection.options.type;
+    if (type !== 'sqlite' && type !== 'postgres') {
+      throw new TypeError(
+        'Omni projection readers require SQLite or PostgreSQL.',
+      );
+    }
+    return createProjectionDialect(type);
+  })();
+
+  const filtersFor = (
+    where: Readonly<Record<string, unknown>> | undefined,
+  ): ProjectionFilter[] => {
+    const filters: ProjectionFilter[] = [];
+    for (const [fieldName, value] of Object.entries(where ?? {})) {
+      const field = registration.definition.fields.find(
+        (candidate) => candidate.name === fieldName,
+      );
+      if (!field || !field.query?.filter?.includes('eq')) {
+        throw new TypeError(
+          `Omni extension reader only permits declared eq fields: ${fieldName}.`,
+        );
+      }
+      filters.push({ field, operator: 'eq', values: [value] });
+    }
+    return filters;
+  };
+
+  const projectMany = async (entities: Entity[]): Promise<Entity[]> => {
+    if (entities.length === 0) return [];
+    const candidates: unknown[] = entities.map(
+      (entity) => entity[identity as keyof Entity] as unknown,
+    );
+    const guids = candidates.filter(
+      (guid): guid is string => typeof guid === 'string',
+    );
+    const owners = await ownerRepository.find({
+      where: { ...ownerWhere, guid: In(guids) },
+    });
+    const ownersByGuid = new Map(owners.map((owner) => [owner.guid, owner]));
+    return entities.flatMap((entity) => {
+      const guid = entity[identity as keyof Entity];
+      const owner =
+        typeof guid === 'string' ? ownersByGuid.get(guid) : undefined;
+      return owner ? [project(entity, owner)] : [];
+    });
+  };
+
+  return freeze({
+    async get(guid: string): Promise<Entity | undefined> {
+      const entity = await extensionRepository.findOne({
+        where: { [scopeColumn]: scope.scopeId, [identity]: guid } as never,
+      });
+      if (!entity) return undefined;
+      const owner = await getOwner(guid);
+      return owner ? project(entity, owner) : undefined;
+    },
+    async list(
+      options: {
+        where?: Readonly<Record<string, unknown>>;
+        take?: number;
+      } = {},
+    ): Promise<Entity[]> {
+      const [entities] = await dialect.findMany(
+        extensionRepository,
+        registration.definition,
+        scope.scopeId,
+        filtersFor(options.where),
+        [],
+        { take: validateReaderTake(options.take) },
+      );
+      return projectMany(entities);
+    },
+  });
+}
+
+function relationReader(
+  manager: EntityManager,
+  scope: OmniScope,
+  registration: OmniRelationProjectionReaderRegistration,
+): OmniRelationProjectionReader {
+  const repository = manager.getRepository(OmniRelationEntity);
+  const fixed = relationWhere(registration.definition);
+  return freeze({
+    async get(guid: string): Promise<OmniRelationEntity | undefined> {
+      const entity = await repository.findOne({
+        where: { scopeId: scope.scopeId, guid, ...fixed } as never,
+      });
+      return entity ?? undefined;
+    },
+    async list(
+      options: {
+        sourceRecordId?: string;
+        targetRecordId?: string;
+        take?: number;
+      } = {},
+    ): Promise<OmniRelationEntity[]> {
+      const { take, ...conditions } = options;
+      return await repository.find({
+        where: { scopeId: scope.scopeId, ...fixed, ...conditions } as never,
+        take: validateReaderTake(take),
+      });
+    },
+  });
+}
+
+/**
+ * Creates an immutable catalog from resource registrations. It has no global
+ * state: each hook binds the catalog to its active transaction manager.
+ */
+export function createOmniProjectionReaderCatalog(
+  registrations: readonly (
+    OmniProjectionReaderRegistration | OmniProjectionReaderCatalogSource
+  )[],
+): OmniProjectionReaderCatalog {
+  const byId = new Map<string, OmniProjectionReaderRegistration>();
+  for (const source of registrations) {
+    const registration = 'reader' in source ? source.reader : source;
+    if (!registration.id || byId.has(registration.id)) {
+      throw new TypeError(
+        'Omni projection reader registrations must have unique non-empty ids.',
+      );
+    }
+    byId.set(registration.id, registration);
+  }
+  const snapshot = freeze(new Map(byId));
+  return freeze({
+    bind(
+      manager: EntityManager,
+      scope: OmniScope,
+    ): OmniProjectionTransactionReaders {
+      return freeze({
+        extension<Entity extends ObjectLiteral = ObjectLiteral>(
+          id: string,
+        ): OmniExtensionProjectionReader<Entity> {
+          const registration = snapshot.get(id);
+          if (!registration || registration.type !== 'extension') {
+            throw new TypeError(
+              `Omni extension projection reader is not registered: ${id}.`,
+            );
+          }
+          return extensionReader(
+            manager,
+            scope,
+            registration,
+          ) as OmniExtensionProjectionReader<Entity>;
+        },
+        relation(id: string): OmniRelationProjectionReader {
+          const registration = snapshot.get(id);
+          if (!registration || registration.type !== 'relation') {
+            throw new TypeError(
+              `Omni relation projection reader is not registered: ${id}.`,
+            );
+          }
+          return relationReader(manager, scope, registration);
+        },
+      });
+    },
+  });
+}
+
+/**
+ * Creates the one Nest provider shared by lifecycle-enabled registrations.
+ * Call it after creating the individual resource registrations, passing those
+ * registrations directly; the catalog captures their immutable reader entries.
+ */
+export function createOmniProjectionReaderCatalogProvider(
+  registrations: readonly (
+    OmniProjectionReaderRegistration | OmniProjectionReaderCatalogSource
+  )[],
+  token: InjectionToken<OmniProjectionReaderCatalog> = OMNI_PROJECTION_READER_CATALOG,
+): Provider {
+  return {
+    provide: token,
+    useValue: createOmniProjectionReaderCatalog(registrations),
+  };
+}

package/src/omni-projection.lifecycle.d.ts

@@ -0,0 +1,20 @@
+import type { InjectionToken } from '@nestjs/common';
+import type { EntityManager, ObjectLiteral } from 'typeorm';
+import type { OmniProjectionTransactionReaders } from './omni-projection.catalog.js';
+import type { OmniScope } from './omni-scope.js';
+export interface OmniProjectionLifecycleContext<Definition, Entity extends ObjectLiteral> {
+    readonly definition: Definition;
+    readonly scope: OmniScope;
+    readonly manager: EntityManager;
+    readonly readers: OmniProjectionTransactionReaders;
+    readonly input: Readonly<Record<string, unknown>>;
+    readonly current?: Entity;
+}
+export interface OmniProjectionLifecycle<Definition, Entity extends ObjectLiteral> {
+    beforeCreate?(context: OmniProjectionLifecycleContext<Definition, Entity>): void | Promise<void>;
+    beforeUpdate?(context: OmniProjectionLifecycleContext<Definition, Entity>): void | Promise<void>;
+    beforeDelete?(context: OmniProjectionLifecycleContext<Definition, Entity>): void | Promise<void>;
+}
+export interface OmniProjectionLifecycleProvider<Definition, Entity extends ObjectLiteral> {
+    readonly token: InjectionToken<OmniProjectionLifecycle<Definition, Entity>>;
+}

package/src/omni-projection.lifecycle.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=omni-projection.lifecycle.js.map

package/src/omni-projection.lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omni-projection.lifecycle.js","sourceRoot":"","sources":["omni-projection.lifecycle.ts"],"names":[],"mappings":""}

package/src/omni-projection.lifecycle.ts

@@ -0,0 +1,53 @@
+import type { InjectionToken } from '@nestjs/common';
+import type { EntityManager, ObjectLiteral } from 'typeorm';
+import type { OmniProjectionTransactionReaders } from './omni-projection.catalog.js';
+import type { OmniScope } from './omni-scope.js';
+
+/**
+ * Transaction-aware policy seam shared by fixed Omni projections. Policies
+ * are optional, but when registered they are invoked by the store itself—not
+ * by transport adapters—so generated REST and GraphQL cannot bypass them.
+ */
+export interface OmniProjectionLifecycleContext<
+  Definition,
+  Entity extends ObjectLiteral,
+> {
+  readonly definition: Definition;
+  readonly scope: OmniScope;
+  readonly manager: EntityManager;
+  /**
+   * Manager-bound, scope-constrained readers registered by the composed
+   * projections. Policies use these instead of reaching for repositories.
+   */
+  readonly readers: OmniProjectionTransactionReaders;
+  readonly input: Readonly<Record<string, unknown>>;
+  /** Present for update and delete after fixed scope/metadata constraints. */
+  readonly current?: Entity;
+}
+
+export interface OmniProjectionLifecycle<
+  Definition,
+  Entity extends ObjectLiteral,
+> {
+  beforeCreate?(
+    context: OmniProjectionLifecycleContext<Definition, Entity>,
+  ): void | Promise<void>;
+  beforeUpdate?(
+    context: OmniProjectionLifecycleContext<Definition, Entity>,
+  ): void | Promise<void>;
+  beforeDelete?(
+    context: OmniProjectionLifecycleContext<Definition, Entity>,
+  ): void | Promise<void>;
+}
+
+/**
+ * A Nest token for a request-scoped policy. Resource registrations inject the
+ * token into their generated service factory, so the policy is shared by REST
+ * and GraphQL but remains app-owned and DI-created.
+ */
+export interface OmniProjectionLifecycleProvider<
+  Definition,
+  Entity extends ObjectLiteral,
+> {
+  readonly token: InjectionToken<OmniProjectionLifecycle<Definition, Entity>>;
+}

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

@@ -0,0 +1,5 @@
+export declare enum OmniRecordStatus {
+    Draft = "draft",
+    Active = "active",
+    Archived = "archived"
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"omni-record-status.enum.js","sourceRoot":"","sources":["omni-record-status.enum.ts"],"names":[],"mappings":";;;AAAA,6CAAmD;AAEnD,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,mCAAe,CAAA;IACf,qCAAiB,CAAA;IACjB,yCAAqB,CAAA;AACvB,CAAC,EAJW,gBAAgB,gCAAhB,gBAAgB,QAI3B;AAED,IAAA,0BAAgB,EAAC,gBAAgB,EAAE;IACjC,IAAI,EAAE,kBAAkB;CACzB,CAAC,CAAC"}

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

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

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

@@ -0,0 +1,2 @@
+import { OmniRecordEntity } from './base/omni-record.entity.js';
+export declare const omniRecordBackendProvidersFactory: (dbConnection: string, reservedRecordKinds?: readonly string[]) => import("./omni-scoped.backend.js").OmniScopedBackendFactoryResult<OmniRecordEntity>;

package/src/omni-record.backend.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.omniRecordBackendProvidersFactory = void 0;
+const omni_record_entity_js_1 = require("./base/omni-record.entity.js");
+const omni_scoped_backend_js_1 = require("./omni-scoped.backend.js");
+const omni_record_service_js_1 = require("./omni-record.service.js");
+const omniRecordBackendProvidersFactory = (dbConnection, reservedRecordKinds = []) => (0, omni_scoped_backend_js_1.omniScopedBackendProvidersFactory)({
+    entityModel: omni_record_entity_js_1.OmniRecordEntity,
+    dbConnection,
+    createService: (repository, scope, options) => new omni_record_service_js_1.OmniRecordService(repository, scope, options.deletion.record, reservedRecordKinds),
+});
+exports.omniRecordBackendProvidersFactory = omniRecordBackendProvidersFactory;
+//# sourceMappingURL=omni-record.backend.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"omni-record.backend.js","sourceRoot":"","sources":["omni-record.backend.ts"],"names":[],"mappings":";;;AAAA,wEAAgE;AAChE,qEAA6E;AAC7E,qEAA6D;AAEtD,MAAM,iCAAiC,GAAG,CAC/C,YAAoB,EACpB,sBAAyC,EAAE,EAC3C,EAAE,CACF,IAAA,0DAAiC,EAAmB;IAClD,WAAW,EAAE,wCAAgB;IAC7B,YAAY;IACZ,aAAa,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAC5C,IAAI,0CAAiB,CACnB,UAAU,EACV,KAAK,EACL,OAAO,CAAC,QAAQ,CAAC,MAAM,EACvB,mBAAmB,CACpB;CACJ,CAAC,CAAC;AAdQ,QAAA,iCAAiC,qCAczC"}