metal-orm 1.1.6 → 1.1.8

package/dist/index.cjs

@@ -395,6 +395,7 @@ __export(index_exports, {
   sub: () => sub,
   substr: () => substr,
   sum: () => sum,
+  syncTreeEntityMetadata: () => syncTreeEntityMetadata,
   synchronizeSchema: () => synchronizeSchema,
   tableRef: () => tableRef,
   tan: () => tan,
@@ -14969,6 +14970,265 @@ var jsonify = (value) => {
   return result;
 };
 
+// src/tree/tree-types.ts
+var DEFAULT_TREE_CONFIG = {
+  parentKey: "parentId",
+  leftKey: "lft",
+  rightKey: "rght",
+  cascadeCallbacks: false
+};
+function isTreeConfig(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  return typeof obj.parentKey === "string" && typeof obj.leftKey === "string" && typeof obj.rightKey === "string";
+}
+function resolveTreeConfig(partial) {
+  return {
+    parentKey: partial.parentKey ?? DEFAULT_TREE_CONFIG.parentKey,
+    leftKey: partial.leftKey ?? DEFAULT_TREE_CONFIG.leftKey,
+    rightKey: partial.rightKey ?? DEFAULT_TREE_CONFIG.rightKey,
+    depthKey: partial.depthKey,
+    scope: partial.scope,
+    cascadeCallbacks: partial.cascadeCallbacks ?? DEFAULT_TREE_CONFIG.cascadeCallbacks,
+    recoverOrder: partial.recoverOrder
+  };
+}
+function validateTreeTable(table, config) {
+  const missingColumns = [];
+  const warnings = [];
+  const requiredColumns = [config.parentKey, config.leftKey, config.rightKey];
+  for (const col2 of requiredColumns) {
+    if (!(col2 in table.columns)) {
+      missingColumns.push(col2);
+    }
+  }
+  if (config.depthKey && !(config.depthKey in table.columns)) {
+    warnings.push(`Optional depth column '${config.depthKey}' not found in table '${table.name}'`);
+  }
+  if (config.scope) {
+    for (const scopeCol of config.scope) {
+      if (!(scopeCol in table.columns)) {
+        missingColumns.push(scopeCol);
+      }
+    }
+  }
+  const leftCol = table.columns[config.leftKey];
+  const rightCol = table.columns[config.rightKey];
+  if (leftCol && leftCol.type !== "int" && leftCol.type !== "integer") {
+    warnings.push(`Left column '${config.leftKey}' should be an integer type`);
+  }
+  if (rightCol && rightCol.type !== "int" && rightCol.type !== "integer") {
+    warnings.push(`Right column '${config.rightKey}' should be an integer type`);
+  }
+  return {
+    valid: missingColumns.length === 0,
+    missingColumns,
+    warnings
+  };
+}
+function getTreeColumns(table, config) {
+  const parentColumn = table.columns[config.parentKey];
+  const leftColumn = table.columns[config.leftKey];
+  const rightColumn = table.columns[config.rightKey];
+  const depthColumn = config.depthKey ? table.columns[config.depthKey] : void 0;
+  const scopeColumns = (config.scope ?? []).map((s) => table.columns[s]).filter(Boolean);
+  if (!parentColumn || !leftColumn || !rightColumn) {
+    throw new Error(
+      `Table '${table.name}' is missing required tree columns. Required: ${config.parentKey}, ${config.leftKey}, ${config.rightKey}`
+    );
+  }
+  return {
+    parentColumn,
+    leftColumn,
+    rightColumn,
+    depthColumn,
+    scopeColumns
+  };
+}
+
+// src/tree/tree-decorator.ts
+var TREE_METADATA_KEY = /* @__PURE__ */ Symbol("metal-orm:tree");
+function Tree(options = {}) {
+  return function(target, context) {
+    const config = resolveTreeConfig(options);
+    const metadataBag = readMetadataBag(context) ?? readMetadataBagFromConstructor(target);
+    const metadata = {
+      config,
+      parentProperty: metadataBag?.tree?.parentProperty,
+      childrenProperty: metadataBag?.tree?.childrenProperty
+    };
+    setTreeMetadataOnClass(target, metadata);
+    registerTreeRelations(target, metadata);
+    return target;
+  };
+}
+function TreeParent() {
+  return function(_value, context) {
+    if (!context.name) {
+      throw new Error("TreeParent decorator requires a property name");
+    }
+    if (context.private) {
+      throw new Error("TreeParent decorator does not support private fields");
+    }
+    const propertyName = String(context.name);
+    const bag = getOrCreateMetadataBag(context);
+    bag.tree = { ...bag.tree, parentProperty: propertyName };
+  };
+}
+function TreeChildren() {
+  return function(_value, context) {
+    if (!context.name) {
+      throw new Error("TreeChildren decorator requires a property name");
+    }
+    if (context.private) {
+      throw new Error("TreeChildren decorator does not support private fields");
+    }
+    const propertyName = String(context.name);
+    const bag = getOrCreateMetadataBag(context);
+    bag.tree = { ...bag.tree, childrenProperty: propertyName };
+  };
+}
+function syncTreeEntityMetadata(ctor, treeMetadata) {
+  const current = getTreeMetadata(ctor);
+  if (!current) return;
+  const metadataBag = readMetadataBagFromConstructor(ctor);
+  const nextParentProperty = treeMetadata?.parentProperty ?? metadataBag?.tree?.parentProperty ?? current.parentProperty;
+  const nextChildrenProperty = treeMetadata?.childrenProperty ?? metadataBag?.tree?.childrenProperty ?? current.childrenProperty;
+  if (nextParentProperty !== current.parentProperty || nextChildrenProperty !== current.childrenProperty) {
+    setTreeMetadata(ctor, {
+      ...current,
+      parentProperty: nextParentProperty,
+      childrenProperty: nextChildrenProperty
+    });
+  }
+  registerTreeRelations(ctor, {
+    ...current,
+    parentProperty: nextParentProperty,
+    childrenProperty: nextChildrenProperty
+  });
+}
+function getTreeMetadata(target) {
+  return target[TREE_METADATA_KEY];
+}
+function setTreeMetadata(target, metadata) {
+  target[TREE_METADATA_KEY] = metadata;
+}
+var registerTreeRelations = (target, metadata) => {
+  const entityMeta = getEntityMetadata(target);
+  if (!entityMeta) return;
+  if (metadata.parentProperty && !entityMeta.relations[metadata.parentProperty]) {
+    addRelationMetadata(target, metadata.parentProperty, {
+      kind: RelationKinds.BelongsTo,
+      propertyKey: metadata.parentProperty,
+      target: () => target,
+      foreignKey: metadata.config.parentKey
+    });
+    if (entityMeta.table && !entityMeta.table.relations[metadata.parentProperty]) {
+      entityMeta.table.relations[metadata.parentProperty] = belongsTo(
+        entityMeta.table,
+        metadata.config.parentKey
+      );
+    }
+  }
+  if (metadata.childrenProperty && !entityMeta.relations[metadata.childrenProperty]) {
+    addRelationMetadata(target, metadata.childrenProperty, {
+      kind: RelationKinds.HasMany,
+      propertyKey: metadata.childrenProperty,
+      target: () => target,
+      foreignKey: metadata.config.parentKey
+    });
+    if (entityMeta.table && !entityMeta.table.relations[metadata.childrenProperty]) {
+      entityMeta.table.relations[metadata.childrenProperty] = hasMany(
+        entityMeta.table,
+        metadata.config.parentKey
+      );
+    }
+  }
+};
+function setTreeMetadataOnClass(target, metadata) {
+  target[TREE_METADATA_KEY] = metadata;
+}
+function hasTreeBehavior(target) {
+  return getTreeMetadata(target) !== void 0;
+}
+function getTreeConfig(target) {
+  return getTreeMetadata(target)?.config;
+}
+var TreeEntityRegistry = class {
+  entities = /* @__PURE__ */ new Map();
+  tableNames = /* @__PURE__ */ new Map();
+  /**
+   * Registers an entity class with its table name.
+   */
+  register(entityClass, tableName) {
+    this.entities.set(tableName, entityClass);
+    this.tableNames.set(entityClass, tableName);
+  }
+  /**
+   * Gets the entity class for a table name.
+   */
+  getByTableName(tableName) {
+    return this.entities.get(tableName);
+  }
+  /**
+   * Gets the table name for an entity class.
+   */
+  getTableName(entityClass) {
+    return this.tableNames.get(entityClass);
+  }
+  /**
+   * Checks if a table has tree behavior.
+   */
+  isTreeTable(tableName) {
+    const entity = this.entities.get(tableName);
+    return entity ? hasTreeBehavior(entity) : false;
+  }
+  /**
+   * Gets all registered tree entities.
+   */
+  getAll() {
+    const result = [];
+    for (const [tableName, entityClass] of this.entities) {
+      const metadata = getTreeMetadata(entityClass);
+      if (metadata) {
+        result.push({ entityClass, tableName, metadata });
+      }
+    }
+    return result;
+  }
+  /**
+   * Clears the registry.
+   */
+  clear() {
+    this.entities.clear();
+    this.tableNames.clear();
+  }
+};
+var treeEntityRegistry = new TreeEntityRegistry();
+function getTreeBounds(entity, config) {
+  const data = entity;
+  const lft = data[config.leftKey];
+  const rght = data[config.rightKey];
+  if (typeof lft !== "number" || typeof rght !== "number") {
+    return null;
+  }
+  return { lft, rght };
+}
+function getTreeParentId(entity, config) {
+  return entity[config.parentKey];
+}
+function setTreeBounds(entity, config, lft, rght, depth) {
+  const data = entity;
+  data[config.leftKey] = lft;
+  data[config.rightKey] = rght;
+  if (config.depthKey && depth !== void 0) {
+    data[config.depthKey] = depth;
+  }
+}
+function setTreeParentId(entity, config, parentId) {
+  entity[config.parentKey] = parentId;
+}
+
 // src/decorators/entity.ts
 var toSnakeCase2 = (value) => {
   return value.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[^a-z0-9_]+/gi, "_").replace(/__+/g, "_").replace(/^_|_$/g, "").toLowerCase();
@@ -15012,6 +15272,7 @@ function Entity(options = {}) {
         addRelationMetadata(ctor, entry.propertyName, relationCopy);
       }
     }
+    syncTreeEntityMetadata(ctor, bag?.tree);
     return ctor;
   };
 }
@@ -17938,208 +18199,6 @@ function extractReusableSchemas(schema, existing = {}, prefix = "") {
   return existing;
 }
 
-// src/tree/tree-types.ts
-var DEFAULT_TREE_CONFIG = {
-  parentKey: "parentId",
-  leftKey: "lft",
-  rightKey: "rght",
-  cascadeCallbacks: false
-};
-function isTreeConfig(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const obj = value;
-  return typeof obj.parentKey === "string" && typeof obj.leftKey === "string" && typeof obj.rightKey === "string";
-}
-function resolveTreeConfig(partial) {
-  return {
-    parentKey: partial.parentKey ?? DEFAULT_TREE_CONFIG.parentKey,
-    leftKey: partial.leftKey ?? DEFAULT_TREE_CONFIG.leftKey,
-    rightKey: partial.rightKey ?? DEFAULT_TREE_CONFIG.rightKey,
-    depthKey: partial.depthKey,
-    scope: partial.scope,
-    cascadeCallbacks: partial.cascadeCallbacks ?? DEFAULT_TREE_CONFIG.cascadeCallbacks,
-    recoverOrder: partial.recoverOrder
-  };
-}
-function validateTreeTable(table, config) {
-  const missingColumns = [];
-  const warnings = [];
-  const requiredColumns = [config.parentKey, config.leftKey, config.rightKey];
-  for (const col2 of requiredColumns) {
-    if (!(col2 in table.columns)) {
-      missingColumns.push(col2);
-    }
-  }
-  if (config.depthKey && !(config.depthKey in table.columns)) {
-    warnings.push(`Optional depth column '${config.depthKey}' not found in table '${table.name}'`);
-  }
-  if (config.scope) {
-    for (const scopeCol of config.scope) {
-      if (!(scopeCol in table.columns)) {
-        missingColumns.push(scopeCol);
-      }
-    }
-  }
-  const leftCol = table.columns[config.leftKey];
-  const rightCol = table.columns[config.rightKey];
-  if (leftCol && leftCol.type !== "int" && leftCol.type !== "integer") {
-    warnings.push(`Left column '${config.leftKey}' should be an integer type`);
-  }
-  if (rightCol && rightCol.type !== "int" && rightCol.type !== "integer") {
-    warnings.push(`Right column '${config.rightKey}' should be an integer type`);
-  }
-  return {
-    valid: missingColumns.length === 0,
-    missingColumns,
-    warnings
-  };
-}
-function getTreeColumns(table, config) {
-  const parentColumn = table.columns[config.parentKey];
-  const leftColumn = table.columns[config.leftKey];
-  const rightColumn = table.columns[config.rightKey];
-  const depthColumn = config.depthKey ? table.columns[config.depthKey] : void 0;
-  const scopeColumns = (config.scope ?? []).map((s) => table.columns[s]).filter(Boolean);
-  if (!parentColumn || !leftColumn || !rightColumn) {
-    throw new Error(
-      `Table '${table.name}' is missing required tree columns. Required: ${config.parentKey}, ${config.leftKey}, ${config.rightKey}`
-    );
-  }
-  return {
-    parentColumn,
-    leftColumn,
-    rightColumn,
-    depthColumn,
-    scopeColumns
-  };
-}
-
-// src/tree/tree-decorator.ts
-var TREE_METADATA_KEY = /* @__PURE__ */ Symbol("metal-orm:tree");
-function Tree(options = {}) {
-  return function(target) {
-    const config = resolveTreeConfig(options);
-    const metadata = { config };
-    setTreeMetadataOnClass(target, metadata);
-    return target;
-  };
-}
-function TreeParent() {
-  return function(_value, context) {
-    const propertyName = String(context.name);
-    context.addInitializer(function() {
-      const constructor = this.constructor;
-      const metadata = getTreeMetadata(constructor);
-      if (metadata) {
-        metadata.parentProperty = propertyName;
-        setTreeMetadata(constructor, metadata);
-      }
-    });
-  };
-}
-function TreeChildren() {
-  return function(_value, context) {
-    const propertyName = String(context.name);
-    context.addInitializer(function() {
-      const constructor = this.constructor;
-      const metadata = getTreeMetadata(constructor);
-      if (metadata) {
-        metadata.childrenProperty = propertyName;
-        setTreeMetadata(constructor, metadata);
-      }
-    });
-  };
-}
-function getTreeMetadata(target) {
-  return target[TREE_METADATA_KEY];
-}
-function setTreeMetadata(target, metadata) {
-  target[TREE_METADATA_KEY] = metadata;
-}
-function setTreeMetadataOnClass(target, metadata) {
-  target[TREE_METADATA_KEY] = metadata;
-}
-function hasTreeBehavior(target) {
-  return getTreeMetadata(target) !== void 0;
-}
-function getTreeConfig(target) {
-  return getTreeMetadata(target)?.config;
-}
-var TreeEntityRegistry = class {
-  entities = /* @__PURE__ */ new Map();
-  tableNames = /* @__PURE__ */ new Map();
-  /**
-   * Registers an entity class with its table name.
-   */
-  register(entityClass, tableName) {
-    this.entities.set(tableName, entityClass);
-    this.tableNames.set(entityClass, tableName);
-  }
-  /**
-   * Gets the entity class for a table name.
-   */
-  getByTableName(tableName) {
-    return this.entities.get(tableName);
-  }
-  /**
-   * Gets the table name for an entity class.
-   */
-  getTableName(entityClass) {
-    return this.tableNames.get(entityClass);
-  }
-  /**
-   * Checks if a table has tree behavior.
-   */
-  isTreeTable(tableName) {
-    const entity = this.entities.get(tableName);
-    return entity ? hasTreeBehavior(entity) : false;
-  }
-  /**
-   * Gets all registered tree entities.
-   */
-  getAll() {
-    const result = [];
-    for (const [tableName, entityClass] of this.entities) {
-      const metadata = getTreeMetadata(entityClass);
-      if (metadata) {
-        result.push({ entityClass, tableName, metadata });
-      }
-    }
-    return result;
-  }
-  /**
-   * Clears the registry.
-   */
-  clear() {
-    this.entities.clear();
-    this.tableNames.clear();
-  }
-};
-var treeEntityRegistry = new TreeEntityRegistry();
-function getTreeBounds(entity, config) {
-  const data = entity;
-  const lft = data[config.leftKey];
-  const rght = data[config.rightKey];
-  if (typeof lft !== "number" || typeof rght !== "number") {
-    return null;
-  }
-  return { lft, rght };
-}
-function getTreeParentId(entity, config) {
-  return entity[config.parentKey];
-}
-function setTreeBounds(entity, config, lft, rght, depth) {
-  const data = entity;
-  data[config.leftKey] = lft;
-  data[config.rightKey] = rght;
-  if (config.depthKey && depth !== void 0) {
-    data[config.depthKey] = depth;
-  }
-}
-function setTreeParentId(entity, config, parentId) {
-  entity[config.parentKey] = parentId;
-}
-
 // src/dto/openapi/generators/tree.ts
 function threadedNodeToOpenApiSchema(target, options) {
   const componentName = options?.componentName;
@@ -20164,6 +20223,7 @@ var TagIndex = class {
   sub,
   substr,
   sum,
+  syncTreeEntityMetadata,
   synchronizeSchema,
   tableRef,
   tan,