metal-orm 1.0.103 → 1.0.105

package/src/orm/relations/has-one.ts

@@ -1,158 +1,162 @@
-import { HasOneReferenceApi } from '../../schema/types.js';
-import { EntityContext } from '../entity-context.js';
-import { RelationKey } from '../runtime-types.js';
-import { HasOneRelation } from '../../schema/relation.js';
-import { TableDef } from '../../schema/table.js';
-import { EntityMeta, getHydrationRecord, hasEntityMeta } from '../entity-meta.js';
-
-type Row = Record<string, unknown>;
-
-const toKey = (value: unknown): string => (value === null || value === undefined ? '' : String(value));
-
-const hideInternal = (obj: object, keys: string[]): void => {
-  for (const key of keys) {
-    Object.defineProperty(obj, key, {
-      value: obj[key],
-      writable: false,
-      configurable: false,
-      enumerable: false
-    });
-  }
-};
-
-/**
- * Default implementation of a has-one reference.
- * Manages a reference to a child entity where the child carries the foreign key.
- *
- * @template TChild The type of the child entity.
- */
-export class DefaultHasOneReference<TChild extends object> implements HasOneReferenceApi<TChild> {
-  private loaded = false;
-  private current: TChild | null = null;
-
-  /**
-   * @param ctx The entity context for tracking changes.
-   * @param meta Metadata for the parent entity.
-   * @param root The parent entity instance.
-   * @param relationName The name of the relation.
-   * @param relation Relation definition.
-   * @param rootTable Table definition of the parent entity.
-   * @param loader Function to load the child entity.
-   * @param createEntity Function to create entity instances from rows.
-   * @param localKey The local key on the parent entity used for the relation.
-   */
-  constructor(
-    private readonly ctx: EntityContext,
-    private readonly meta: EntityMeta<TableDef>,
-    private readonly root: unknown,
-    private readonly relationName: string,
-    private readonly relation: HasOneRelation,
-    private readonly rootTable: TableDef,
-    private readonly loader: () => Promise<Map<string, Row>>,
-    private readonly createEntity: (row: Row) => TChild,
-    private readonly localKey: string
-  ) {
-    hideInternal(this, [
-      'ctx',
-      'meta',
-      'root',
-      'relationName',
-      'relation',
-      'rootTable',
-      'loader',
-      'createEntity',
-      'localKey'
-    ]);
-    this.populateFromHydrationCache();
-  }
-
-  async load(): Promise<TChild | null> {
-    if (this.loaded) return this.current;
-    const map = await this.loader();
-    const keyValue = (this.root as Record<string, unknown>)[this.localKey];
-    if (keyValue === undefined || keyValue === null) {
-      this.loaded = true;
-      return this.current;
-    }
-    const row = map.get(toKey(keyValue));
-    this.current = row ? this.createEntity(row) : null;
-    this.loaded = true;
-    return this.current;
-  }
-
-  get(): TChild | null {
-    return this.current;
-  }
-
-  set(data: Partial<TChild> | TChild | null): TChild | null {
-    if (data === null) {
-      return this.detachCurrent();
-    }
-
-    const entity = hasEntityMeta(data) ? (data as TChild) : this.createEntity(data as Row);
-    if (this.current && this.current !== entity) {
-      this.ctx.registerRelationChange(
-        this.root,
-        this.relationKey,
-        this.rootTable,
-        this.relationName,
-        this.relation,
-        { kind: 'remove', entity: this.current }
-      );
-    }
-
-    this.assignForeignKey(entity);
-    this.current = entity;
-    this.loaded = true;
-
-    this.ctx.registerRelationChange(
-      this.root,
-      this.relationKey,
-      this.rootTable,
-      this.relationName,
-      this.relation,
-      { kind: 'attach', entity }
-    );
-
-    return entity;
-  }
-
-  toJSON(): TChild | null {
-    return this.current;
-  }
-
-  private detachCurrent(): TChild | null {
-    const previous = this.current;
-    if (!previous) return null;
-    this.current = null;
-    this.loaded = true;
-    this.ctx.registerRelationChange(
-      this.root,
-      this.relationKey,
-      this.rootTable,
-      this.relationName,
-      this.relation,
-      { kind: 'remove', entity: previous }
-    );
-    return null;
-  }
-
-  private assignForeignKey(entity: TChild): void {
-    const keyValue = (this.root as Record<string, unknown>)[this.localKey];
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    (entity as Row)[this.relation.foreignKey] = keyValue;
-  }
-
-  private get relationKey(): RelationKey {
-    return `${this.rootTable.name}.${this.relationName}`;
-  }
-
-  private populateFromHydrationCache(): void {
-    const keyValue = (this.root as Record<string, unknown>)[this.localKey];
-    if (keyValue === undefined || keyValue === null) return;
-    const row = getHydrationRecord(this.meta, this.relationName, keyValue);
-    if (!row) return;
-    this.current = this.createEntity(row);
-    this.loaded = true;
-  }
-}
+import { HasOneReferenceApi } from '../../schema/types.js';
+import { EntityContext } from '../entity-context.js';
+import { RelationKey } from '../runtime-types.js';
+import { HasOneRelation } from '../../schema/relation.js';
+import { TableDef } from '../../schema/table.js';
+import { EntityMeta, getHydrationRecord, hasEntityMeta } from '../entity-meta.js';
+
+type Row = Record<string, unknown>;
+
+const toKey = (value: unknown): string => (value === null || value === undefined ? '' : String(value));
+
+const hideInternal = (obj: object, keys: string[]): void => {
+  for (const key of keys) {
+    Object.defineProperty(obj, key, {
+      value: obj[key],
+      writable: false,
+      configurable: true,  // Must be configurable for Proxy get trap to work properly
+      enumerable: false
+    });
+  }
+};
+
+/**
+ * Default implementation of a has-one reference.
+ * Manages a reference to a child entity where the child carries the foreign key.
+ *
+ * @template TChild The type of the child entity.
+ */
+export class DefaultHasOneReference<TChild extends object> implements HasOneReferenceApi<TChild> {
+  #loaded = false;
+  #current: TChild | null = null;
+
+  /**
+   * @param ctx The entity context for tracking changes.
+   * @param meta Metadata for the parent entity.
+   * @param root The parent entity instance.
+   * @param relationName The name of the relation.
+   * @param relation Relation definition.
+   * @param rootTable Table definition of the parent entity.
+   * @param loader Function to load the child entity.
+   * @param createEntity Function to create entity instances from rows.
+   * @param localKey The local key on the parent entity used for the relation.
+   */
+  constructor(
+    private readonly ctx: EntityContext,
+    private readonly meta: EntityMeta<TableDef>,
+    private readonly root: unknown,
+    private readonly relationName: string,
+    private readonly relation: HasOneRelation,
+    private readonly rootTable: TableDef,
+    private readonly loader: () => Promise<Map<string, Row>>,
+    private readonly createEntity: (row: Row) => TChild,
+    private readonly localKey: string
+  ) {
+    hideInternal(this, [
+      'ctx',
+      'meta',
+      'root',
+      'relationName',
+      'relation',
+      'rootTable',
+      'loader',
+      'createEntity',
+      'localKey'
+    ]);
+    this.populateFromHydrationCache();
+  }
+
+  async load(): Promise<TChild | null> {
+    if (this.#loaded) return this.#current;
+    const map = await this.loader();
+    const keyValue = (this.root as Record<string, unknown>)[this.localKey];
+    if (keyValue === undefined || keyValue === null) {
+      this.#loaded = true;
+      return this.#current;
+    }
+    const row = map.get(toKey(keyValue));
+    this.#current = row ? this.createEntity(row) : null;
+    this.#loaded = true;
+    return this.#current;
+  }
+
+  get(): TChild | null {
+    return this.#current;
+  }
+
+  set(data: Partial<TChild> | TChild | null): TChild | null {
+    if (data === null) {
+      return this.detachCurrent();
+    }
+
+    const entity = hasEntityMeta(data) ? (data as TChild) : this.createEntity(data as Row);
+    if (this.#current && this.#current !== entity) {
+      this.ctx.registerRelationChange(
+        this.root,
+        this.relationKey,
+        this.rootTable,
+        this.relationName,
+        this.relation,
+        { kind: 'remove', entity: this.#current }
+      );
+    }
+
+    this.assignForeignKey(entity);
+    this.#current = entity;
+    this.#loaded = true;
+
+    this.ctx.registerRelationChange(
+      this.root,
+      this.relationKey,
+      this.rootTable,
+      this.relationName,
+      this.relation,
+      { kind: 'attach', entity }
+    );
+
+    return entity;
+  }
+
+  isLoaded(): boolean {
+    return this.#loaded;
+  }
+
+  toJSON(): TChild | null {
+    return this.#current;
+  }
+
+  private detachCurrent(): TChild | null {
+    const previous = this.#current;
+    if (!previous) return null;
+    this.#current = null;
+    this.#loaded = true;
+    this.ctx.registerRelationChange(
+      this.root,
+      this.relationKey,
+      this.rootTable,
+      this.relationName,
+      this.relation,
+      { kind: 'remove', entity: previous }
+    );
+    return null;
+  }
+
+  private assignForeignKey(entity: TChild): void {
+    const keyValue = (this.root as Record<string, unknown>)[this.localKey];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    (entity as Row)[this.relation.foreignKey] = keyValue;
+  }
+
+  private get relationKey(): RelationKey {
+    return `${this.rootTable.name}.${this.relationName}`;
+  }
+
+  private populateFromHydrationCache(): void {
+    const keyValue = (this.root as Record<string, unknown>)[this.localKey];
+    if (keyValue === undefined || keyValue === null) return;
+    const row = getHydrationRecord(this.meta, this.relationName, keyValue);
+    if (!row) return;
+    this.#current = this.createEntity(row);
+    this.#loaded = true;
+  }
+}