metal-orm 1.0.2 → 1.0.4

package/src/utils/raw-column-parser.ts

@@ -0,0 +1,32 @@
+import { ColumnNode } from '../ast/expression';
+import { CommonTableExpressionNode } from '../ast/query';
+
+/**
+ * Best-effort helper that tries to convert a raw column expression into a `ColumnNode`.
+ * This parser is intentionally limited; use it only for simple references or function calls.
+ */
+export const parseRawColumn = (
+  col: string,
+  tableName: string,
+  ctes?: CommonTableExpressionNode[]
+): ColumnNode => {
+  if (col.includes('(')) {
+    const [fn, rest] = col.split('(');
+    const colName = rest.replace(')', '');
+    const [table, name] = colName.includes('.') ? colName.split('.') : [tableName, colName];
+    return { type: 'Column', table, name, alias: col };
+  }
+
+  if (col.includes('.')) {
+    const [potentialCteName, columnName] = col.split('.');
+    const hasCte = ctes?.some(cte => cte.name === potentialCteName);
+
+    if (hasCte) {
+      return { type: 'Column', table: tableName, name: col };
+    }
+
+    return { type: 'Column', table: potentialCteName, name: columnName };
+  }
+
+  return { type: 'Column', table: tableName, name: col };
+};

package/src/utils/relation-alias.ts

@@ -0,0 +1,43 @@
+/**
+ * Separator used when projecting relational columns
+ */
+const RELATION_SEPARATOR = '__';
+
+/**
+ * Parts of a relation alias
+ */
+export interface RelationAliasParts {
+  /**
+   * Relation name (left side of the separator)
+   */
+  relationName: string;
+  /**
+   * Column name (right side of the separator)
+   */
+  columnName: string;
+}
+
+/**
+ * Builds a relation alias from the relation name and column name components.
+ */
+export const makeRelationAlias = (relationName: string, columnName: string): string =>
+  `${relationName}${RELATION_SEPARATOR}${columnName}`;
+
+/**
+ * Parses a relation alias into its relation/column components.
+ * Returns `null` when the alias does not follow the `relation__column` pattern.
+ */
+export const parseRelationAlias = (alias: string): RelationAliasParts | null => {
+  const idx = alias.indexOf(RELATION_SEPARATOR);
+  if (idx === -1) return null;
+  return {
+    relationName: alias.slice(0, idx),
+    columnName: alias.slice(idx + RELATION_SEPARATOR.length)
+  };
+};
+
+/**
+ * Determines whether an alias represents a relation column by checking the `__` convention.
+ */
+export const isRelationAlias = (alias?: string): boolean =>
+  !!alias && alias.includes(RELATION_SEPARATOR);