metal-orm 1.0.97 → 1.0.98

package/dist/index.d.cts

@@ -4247,6 +4247,21 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
         page: number;
         pageSize: number;
     }): Promise<PaginatedResult<T>>;
+    /**
+     * Executes the query and returns an array of values for a single column.
+     * This is a convenience method to avoid manual `.map(r => r.column)`.
+     *
+     * @param column - The column name to extract
+     * @param ctx - ORM session context
+     * @returns Promise of an array containing only the values of the specified column
+     * @example
+     * const acronyms = await selectFromEntity(Organization)
+     *   .select('acronym')
+     *   .distinct(O.acronym)
+     *   .pluck('acronym', session);
+     * // ['NASA', 'UN', 'WHO']
+     */
+    pluck<K extends keyof T & string>(column: K, ctx: OrmSession): Promise<T[K][]>;
     /**
      * Executes the query with provided execution and hydration contexts
      * @param execCtx - Execution context

package/dist/index.d.ts

@@ -4247,6 +4247,21 @@ declare class SelectQueryBuilder<T = EntityInstance<TableDef>, TTable extends Ta
         page: number;
         pageSize: number;
     }): Promise<PaginatedResult<T>>;
+    /**
+     * Executes the query and returns an array of values for a single column.
+     * This is a convenience method to avoid manual `.map(r => r.column)`.
+     *
+     * @param column - The column name to extract
+     * @param ctx - ORM session context
+     * @returns Promise of an array containing only the values of the specified column
+     * @example
+     * const acronyms = await selectFromEntity(Organization)
+     *   .select('acronym')
+     *   .distinct(O.acronym)
+     *   .pluck('acronym', session);
+     * // ['NASA', 'UN', 'WHO']
+     */
+    pluck<K extends keyof T & string>(column: K, ctx: OrmSession): Promise<T[K][]>;
     /**
      * Executes the query with provided execution and hydration contexts
      * @param execCtx - Execution context

package/dist/index.js

@@ -7224,6 +7224,24 @@ var SelectQueryBuilder = class _SelectQueryBuilder {
     const builder = this.ensureDefaultSelection();
     return executePagedQuery(builder, session, options, (sess) => builder.count(sess));
   }
+  /**
+   * Executes the query and returns an array of values for a single column.
+   * This is a convenience method to avoid manual `.map(r => r.column)`.
+   *
+   * @param column - The column name to extract
+   * @param ctx - ORM session context
+   * @returns Promise of an array containing only the values of the specified column
+   * @example
+   * const acronyms = await selectFromEntity(Organization)
+   *   .select('acronym')
+   *   .distinct(O.acronym)
+   *   .pluck('acronym', session);
+   * // ['NASA', 'UN', 'WHO']
+   */
+  async pluck(column, ctx) {
+    const rows = await this.executePlain(ctx);
+    return rows.map((r) => r[column]);
+  }
   /**
    * Executes the query with provided execution and hydration contexts
    * @param execCtx - Execution context