n8n-nodes-base 2.44.1 → 2.45.0

package/dist/nodes/MondayCom/V2/helpers/accountSearch.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEARCH_STRATEGY_OPTIONS = exports.SEARCH_OPERATION_VALUES = exports.SEARCH_OPERATION_ENTITY = exports.SEARCH_DEFAULT_LIMIT = exports.SEARCH_MAX_LIMIT = void 0;
+exports.buildAccountSearchPlan = buildAccountSearchPlan;
+exports.flattenSearchResults = flattenSearchResults;
+/**
+ * Cross-entity account search (the `search` root query, API 2026-07+;
+ * updates need 2026-10+ — covered by the node's pin).
+ *
+ * The query returns a SearchNamespace with one field per entity type, so a
+ * single request can search every selected type at once. Facts verified live
+ * (2026-07-19) that shape this module:
+ * - `limit` is hard-capped at 20 per entity type, default 10, and there is
+ *   NO pagination — results come back relevance-ordered, top-N only.
+ * - Each result = { id, indexed_data, live_data }: indexed_data is the fast
+ *   (possibly stale) search-index snapshot; live_data resolves the full
+ *   entity from the core API and is null when the entity was deleted, is
+ *   inaccessible, or the index lags — so live_data is opt-in here.
+ * - GraphQL rejects declared-but-unused variables, so the variable
+ *   definitions are built from the entity/filter combination actually used.
+ * - Filter args differ per entity (introspected; the docs are incomplete):
+ *   items/boards take board_ids+workspace_ids, updates board_ids+creator_ids.
+ *
+ * The namespace also searches docs, users, workspaces and timeline items;
+ * those come in with the resources that need them.
+ */
+/** The API's hard cap on results per entity type (no pagination exists). */
+exports.SEARCH_MAX_LIMIT = 20;
+/** The API's default per-entity limit. */
+exports.SEARCH_DEFAULT_LIMIT = 10;
+/**
+ * Operation value → SearchNamespace entity field. One node operation per
+ * searchable entity type (product decision 2026-07-19 — each operation
+ * shows only the filters its API field accepts).
+ */
+exports.SEARCH_OPERATION_ENTITY = {
+    searchBoardsAccount: 'boards',
+    searchItemsAccount: 'items',
+    searchUpdatesAccount: 'updates',
+};
+/** All Search operation values — for shared displayOptions in the node. */
+exports.SEARCH_OPERATION_VALUES = Object.keys(exports.SEARCH_OPERATION_ENTITY);
+/** SearchStrategy enum (introspected live). */
+exports.SEARCH_STRATEGY_OPTIONS = [
+    {
+        name: 'Balanced',
+        value: 'BALANCED',
+        description: 'Default trade-off between result quality and response time',
+    },
+    { name: 'Quality', value: 'QUALITY', description: 'Best results, slower response' },
+    { name: 'Speed', value: 'SPEED', description: 'Fastest response, simpler matching' },
+];
+/** indexed_data field selection per entity (introspected — full field sets). */
+const INDEXED_FIELDS = {
+    items: 'id name url board_id workspace_id',
+    boards: 'id name description url workspace_id creator_id',
+    updates: 'id body creator_id item_id board_id created_at updated_at',
+};
+/**
+ * Bounded live_data selections — never unbounded connections (live_data is
+ * the full core-API entity; an item's column_values or a board's items would
+ * blow the complexity budget). All verified live.
+ */
+const LIVE_FIELDS = {
+    items: 'id name state url created_at updated_at board { id name } group { id title }',
+    boards: 'id name state board_kind type url items_count workspace { id name }',
+    updates: 'id body text_body created_at updated_at creator { id name } item_id',
+};
+/** Singular entityType tag emitted on each output row, per namespace field. */
+const ENTITY_TYPE_TAG = {
+    items: 'item',
+    boards: 'board',
+    updates: 'update',
+};
+/** Which optional filter args each entity field accepts (introspected). */
+const ENTITY_FILTER_ARGS = {
+    items: ['board_ids', 'workspace_ids'],
+    boards: ['board_ids', 'workspace_ids'],
+    updates: ['board_ids', 'creator_ids'],
+};
+/** Maps a filter arg name to its GraphQL variable name and type. */
+const FILTER_VARIABLES = {
+    board_ids: { variable: 'boardIds', type: '[ID!]' },
+    workspace_ids: { variable: 'workspaceIds', type: '[ID!]' },
+    creator_ids: { variable: 'creatorIds', type: '[ID!]' },
+};
+/**
+ * Builds the single search request covering all selected entity types.
+ * Only entities the caller selected appear in the document, and only
+ * variables that are actually referenced get declared (GraphQL rejects
+ * unused variable definitions). Filters ride only on the entities whose
+ * field accepts them — e.g. a workspace filter is silently inapplicable to
+ * update search because the API offers no such argument there.
+ */
+function buildAccountSearchPlan(searchText, entities, includeLiveData, limit, strategy, filters = {}) {
+    const selected = entities.filter((entity) => INDEXED_FIELDS[entity] !== undefined);
+    const variables = {
+        q: searchText,
+        limit: Math.max(1, Math.min(limit, exports.SEARCH_MAX_LIMIT)),
+    };
+    const varDefs = ['$q: String!', '$limit: Int'];
+    if (strategy) {
+        variables.strategy = strategy;
+        varDefs.push('$strategy: SearchStrategy');
+    }
+    const dateRange = {};
+    if (filters.createdAfter)
+        dateRange.created_after = filters.createdAfter;
+    if (filters.createdBefore)
+        dateRange.created_before = filters.createdBefore;
+    if (filters.updatedAfter)
+        dateRange.updated_after = filters.updatedAfter;
+    if (filters.updatedBefore)
+        dateRange.updated_before = filters.updatedBefore;
+    if (Object.keys(dateRange).length > 0) {
+        variables.dateRange = dateRange;
+        varDefs.push('$dateRange: CrossEntityDateRangeInput');
+    }
+    const filterValues = {
+        board_ids: filters.boardIds?.length ? filters.boardIds : undefined,
+        workspace_ids: filters.workspaceIds?.length ? filters.workspaceIds : undefined,
+        creator_ids: filters.creatorIds?.length ? filters.creatorIds : undefined,
+    };
+    const declaredFilterVars = new Set();
+    const fields = selected.map((entity) => {
+        const args = ['query: $q', 'limit: $limit'];
+        if (strategy)
+            args.push('strategy: $strategy');
+        if (variables.dateRange)
+            args.push('date_range: $dateRange');
+        for (const argName of ENTITY_FILTER_ARGS[entity]) {
+            if (filterValues[argName] === undefined)
+                continue;
+            const { variable, type } = FILTER_VARIABLES[argName];
+            args.push(`${argName}: $${variable}`);
+            if (!declaredFilterVars.has(variable)) {
+                declaredFilterVars.add(variable);
+                varDefs.push(`$${variable}: ${type}`);
+                variables[variable] = filterValues[argName];
+            }
+        }
+        const liveSelection = includeLiveData ? ` live_data { ${LIVE_FIELDS[entity]} }` : '';
+        return `${entity}(${args.join(', ')}) { results { id indexed_data { ${INDEXED_FIELDS[entity]} }${liveSelection} } }`;
+    });
+    return {
+        query: `query (${varDefs.join(', ')}) { search { ${fields.join(' ')} } }`,
+        variables,
+    };
+}
+/**
+ * Flattens the SearchNamespace response into one output row per result:
+ * entityType tag + the indexed fields at the top level (+ liveData object
+ * when requested — null there means deleted/inaccessible/index-lag, which
+ * is API behavior worth surfacing rather than dropping the row).
+ */
+function flattenSearchResults(searchData, entities, includeLiveData) {
+    const rows = [];
+    for (const entity of entities) {
+        const container = searchData?.[entity];
+        for (const result of container?.results ?? []) {
+            const row = {
+                entityType: ENTITY_TYPE_TAG[entity] ?? entity,
+                id: result.id,
+                ...(result.indexed_data ?? {}),
+            };
+            if (includeLiveData) {
+                row.liveData = result.live_data ?? null;
+            }
+            rows.push(row);
+        }
+    }
+    return rows;
+}
+//# sourceMappingURL=accountSearch.js.map

package/dist/nodes/MondayCom/V2/helpers/accountSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountSearch.js","sourceRoot":"","sources":["../../../../../nodes/MondayCom/V2/helpers/accountSearch.ts"],"names":[],"mappings":"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"}

package/dist/nodes/MondayCom/V2/helpers/aggregate.d.ts

@@ -0,0 +1,76 @@
+import type { IDataObject, INodePropertyOptions } from 'n8n-workflow';
+/** Calculation dropdown for the UI (alphabetized per n8n lint). */
+export declare const AGGREGATE_FUNCTION_OPTIONS: INodePropertyOptions[];
+export declare const AGGREGATE_DATE_GROUPING_OPTIONS: INodePropertyOptions[];
+/** Synthetic group-by choice for the board's groups (the API accepts "group"). */
+export declare const BOARD_GROUP_COLUMN_ID = "group";
+export interface AggregateCalculationRow {
+    function: string;
+    columnId?: string;
+    outputName?: string;
+}
+export interface AggregateGroupByRow {
+    columnId: string;
+    dateGrouping?: string;
+}
+export interface AggregateColumnMeta {
+    id: string;
+    title: string;
+    type: string;
+}
+/** How one select element maps back to an output field when parsing results. */
+interface AliasPlanEntry {
+    alias: string;
+    outputKey: string;
+    kind: 'group' | 'calculation';
+    /** Set when the value needs epoch-ms → ISO date conversion. */
+    isDate?: boolean;
+    /** Set when "" means "no label" and should become null. */
+    isLabel?: boolean;
+}
+export interface AggregateQueryPlan {
+    /** The AggregateQueryInput variable value. */
+    queryInput: IDataObject;
+    /** One entry per select element, keyed by alias, for result parsing. */
+    aliases: AliasPlanEntry[];
+}
+/** Turns a column title into a friendly snake_case output key. */
+export declare function toOutputKey(title: string): string;
+export declare class AggregateInputError extends Error {
+}
+/**
+ * Compiles the node's Calculations / Group By rows into the
+ * AggregateQueryInput the API expects, plus the alias plan needed to turn
+ * the response back into friendly output rows.
+ */
+export declare function buildAggregateQueryPlan(params: {
+    boardId: string;
+    calculations: AggregateCalculationRow[];
+    groupBys: AggregateGroupByRow[];
+    columns: AggregateColumnMeta[];
+    /** Pre-built items_page-style rules (from buildFilterRules). */
+    filterRules?: IDataObject[];
+    filtersMatch?: string;
+    limit?: number;
+}): AggregateQueryPlan;
+/** The response shape of the aggregate query. */
+export interface AggregateApiResponse {
+    aggregate?: {
+        results?: Array<{
+            entries?: Array<{
+                alias?: string;
+                value?: {
+                    result?: number | null;
+                    value?: unknown;
+                } | null;
+            }>;
+        }>;
+    };
+}
+/**
+ * Turns the API's alias/union-value entries into one flat, friendly object
+ * per result row, keyed by the plan's output keys.
+ */
+export declare function parseAggregateResults(response: AggregateApiResponse, aliases: AliasPlanEntry[]): IDataObject[];
+export {};
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/nodes/MondayCom/V2/helpers/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../../../nodes/MondayCom/V2/helpers/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AA8BtE,mEAAmE;AACnE,eAAO,MAAM,0BAA0B,EAAE,oBAAoB,EAyC5D,CAAC;AAWF,eAAO,MAAM,+BAA+B,EAAE,oBAAoB,EAOjE,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAK7C,MAAM,WAAW,uBAAuB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACb;AAED,gFAAgF;AAChF,UAAU,cAAc;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,GAAG,aAAa,CAAC;IAC9B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAClC,8CAA8C;IAC9C,UAAU,EAAE,WAAW,CAAC;IACxB,wEAAwE;IACxE,OAAO,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAYD,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AAEjD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,uBAAuB,EAAE,CAAC;IACxC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,gEAAgE;IAChE,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,kBAAkB,CAgHrB;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACpC,SAAS,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,KAAK,CAAC;YACf,OAAO,CAAC,EAAE,KAAK,CAAC;gBACf,KAAK,CAAC,EAAE,MAAM,CAAC;gBACf,KAAK,CAAC,EAAE;oBAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;oBAAC,KAAK,CAAC,EAAE,OAAO,CAAA;iBAAE,GAAG,IAAI,CAAC;aAC3D,CAAC,CAAC;SACH,CAAC,CAAC;KACH,CAAC;CACF;AAQD;;;GAGG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,cAAc,EAAE,GACvB,WAAW,EAAE,CA6Bf"}

package/dist/nodes/MondayCom/V2/helpers/aggregate.js

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggregateInputError = exports.BOARD_GROUP_COLUMN_ID = exports.AGGREGATE_DATE_GROUPING_OPTIONS = exports.AGGREGATE_FUNCTION_OPTIONS = void 0;
+exports.toOutputKey = toOutputKey;
+exports.buildAggregateQueryPlan = buildAggregateQueryPlan;
+exports.parseAggregateResults = parseAggregateResults;
+/**
+ * Board: Aggregate Item Data — server-side aggregation via the `aggregate`
+ * GraphQL query. The board's items are counted / summed / averaged on
+ * monday's side; the items themselves are never fetched.
+ *
+ * API quirks this module hides from the user (all verified live 2026-07-15):
+ * - group_by.column_id references the SELECT ALIAS, not the raw column ID.
+ * - Grouping a status/dropdown column directly returns the label's HEX color;
+ *   wrapping the column in the LABEL transform returns the label text, with
+ *   "" for items that have no label.
+ * - Date values (group keys and MIN/MAX results) come back as epoch
+ *   milliseconds.
+ * - An aggregation over zero rows returns { value: null } — the union flips
+ *   from AggregateBasicAggregationResult to AggregateGroupByResult.
+ */
+/** UI → API mapping for the calculation functions the operation exposes. */
+const CALCULATION_FUNCTIONS = {
+    countItems: { api: 'COUNT_ITEMS', keyPrefix: 'count_items' },
+    countValues: { api: 'COUNT', keyPrefix: 'count' },
+    countUnique: { api: 'COUNT_DISTINCT', keyPrefix: 'count_unique' },
+    sum: { api: 'SUM', keyPrefix: 'sum' },
+    average: { api: 'AVERAGE', keyPrefix: 'average' },
+    median: { api: 'MEDIAN', keyPrefix: 'median' },
+    min: { api: 'MIN', keyPrefix: 'min' },
+    max: { api: 'MAX', keyPrefix: 'max' },
+};
+/** Calculation dropdown for the UI (alphabetized per n8n lint). */
+exports.AGGREGATE_FUNCTION_OPTIONS = [
+    {
+        name: 'Average',
+        value: 'average',
+        description: 'The average of a numbers or rating column',
+    },
+    {
+        name: 'Count Items',
+        value: 'countItems',
+        description: 'How many items there are',
+    },
+    {
+        name: 'Count Unique Values',
+        value: 'countUnique',
+        description: 'How many different values a column has',
+    },
+    {
+        name: 'Count Values',
+        value: 'countValues',
+        description: 'How many items have a value in a column',
+    },
+    {
+        name: 'Max',
+        value: 'max',
+        description: 'The highest value of a numbers, rating, or date column',
+    },
+    {
+        name: 'Median',
+        value: 'median',
+        description: 'The median of a numbers or rating column',
+    },
+    {
+        name: 'Min',
+        value: 'min',
+        description: 'The lowest value of a numbers, rating, or date column',
+    },
+    {
+        name: 'Sum',
+        value: 'sum',
+        description: 'The total of a numbers or rating column',
+    },
+];
+/** UI → API mapping for the optional date bucketing on group-by columns. */
+const DATE_GROUPING_FUNCTIONS = {
+    day: 'DATE_TRUNC_DAY',
+    week: 'DATE_TRUNC_WEEK',
+    month: 'DATE_TRUNC_MONTH',
+    quarter: 'DATE_TRUNC_QUARTER',
+    year: 'DATE_TRUNC_YEAR',
+};
+exports.AGGREGATE_DATE_GROUPING_OPTIONS = [
+    { name: 'Individual Dates', value: 'none' },
+    { name: 'By Day', value: 'day' },
+    { name: 'By Week', value: 'week' },
+    { name: 'By Month', value: 'month' },
+    { name: 'By Quarter', value: 'quarter' },
+    { name: 'By Year', value: 'year' },
+];
+/** Synthetic group-by choice for the board's groups (the API accepts "group"). */
+exports.BOARD_GROUP_COLUMN_ID = 'group';
+/** Column types whose grouped value is a label the LABEL transform resolves. */
+const LABEL_GROUP_TYPES = new Set(['status', 'dropdown']);
+/** Turns a column title into a friendly snake_case output key. */
+function toOutputKey(title) {
+    const key = title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    return key || 'column';
+}
+/** Appends _2, _3, … when two elements would produce the same output key. */
+function uniqueKey(key, used) {
+    let candidate = key;
+    for (let suffix = 2; used.has(candidate); suffix++) {
+        candidate = `${key}_${suffix}`;
+    }
+    used.add(candidate);
+    return candidate;
+}
+class AggregateInputError extends Error {
+}
+exports.AggregateInputError = AggregateInputError;
+/**
+ * Compiles the node's Calculations / Group By rows into the
+ * AggregateQueryInput the API expects, plus the alias plan needed to turn
+ * the response back into friendly output rows.
+ */
+function buildAggregateQueryPlan(params) {
+    const columnsById = new Map(params.columns.map((column) => [column.id, column]));
+    const select = [];
+    const groupBy = [];
+    const aliases = [];
+    const usedKeys = new Set();
+    const columnElement = (columnId, alias) => ({
+        type: 'COLUMN',
+        column: { column_id: columnId },
+        as: alias,
+    });
+    params.groupBys.forEach((row, index) => {
+        if (!row.columnId)
+            return;
+        const alias = `g${index}`;
+        const column = columnsById.get(row.columnId);
+        const isBoardGroup = row.columnId === exports.BOARD_GROUP_COLUMN_ID;
+        const title = isBoardGroup ? 'Board Group' : (column?.title ?? row.columnId);
+        const isLabel = column !== undefined && LABEL_GROUP_TYPES.has(column.type);
+        const isDate = column?.type === 'date';
+        const dateFunction = isDate && row.dateGrouping ? DATE_GROUPING_FUNCTIONS[row.dateGrouping] : undefined;
+        if (isLabel) {
+            // LABEL returns the label text; the raw grouped value is the hex color.
+            select.push({
+                type: 'FUNCTION',
+                function: { function: 'LABEL', params: [columnElement(row.columnId, `${alias}_src`)] },
+                as: alias,
+            });
+        }
+        else if (dateFunction) {
+            select.push({
+                type: 'FUNCTION',
+                function: { function: dateFunction, params: [columnElement(row.columnId, `${alias}_src`)] },
+                as: alias,
+            });
+        }
+        else {
+            select.push(columnElement(row.columnId, alias));
+        }
+        // The group_by column_id must be the select element's alias.
+        groupBy.push({ column_id: alias });
+        aliases.push({
+            alias,
+            outputKey: uniqueKey(toOutputKey(title), usedKeys),
+            kind: 'group',
+            isDate,
+            isLabel,
+        });
+    });
+    const calculationRows = params.calculations.filter((row) => row.function);
+    if (calculationRows.length === 0) {
+        throw new AggregateInputError('Add at least one calculation (e.g. Count Items) to aggregate the board');
+    }
+    calculationRows.forEach((row, index) => {
+        const mapping = CALCULATION_FUNCTIONS[row.function];
+        if (!mapping) {
+            throw new AggregateInputError(`Unknown calculation function "${row.function}"`);
+        }
+        const alias = `c${index}`;
+        const needsColumn = row.function !== 'countItems';
+        if (needsColumn && !row.columnId) {
+            throw new AggregateInputError(`Calculation ${index + 1} (${row.function}) needs a column to work on`);
+        }
+        const column = row.columnId ? columnsById.get(row.columnId) : undefined;
+        const defaultKey = needsColumn
+            ? `${mapping.keyPrefix}_${toOutputKey(column?.title ?? String(row.columnId))}`
+            : mapping.keyPrefix;
+        select.push({
+            type: 'FUNCTION',
+            function: {
+                function: mapping.api,
+                ...(needsColumn ? { params: [columnElement(row.columnId, `${alias}_src`)] } : {}),
+            },
+            as: alias,
+        });
+        aliases.push({
+            alias,
+            outputKey: uniqueKey(row.outputName?.trim() || defaultKey, usedKeys),
+            kind: 'calculation',
+            // MIN/MAX on a date column return epoch milliseconds.
+            isDate: (row.function === 'min' || row.function === 'max') && column?.type === 'date',
+        });
+    });
+    const queryInput = {
+        from: { type: 'TABLE', id: params.boardId },
+        select,
+    };
+    if (groupBy.length > 0) {
+        queryInput.group_by = groupBy;
+    }
+    if (params.filterRules && params.filterRules.length > 0) {
+        queryInput.query = {
+            rules: params.filterRules,
+            operator: params.filtersMatch ?? 'and',
+        };
+    }
+    if (params.limit !== undefined) {
+        queryInput.limit = params.limit;
+    }
+    return { queryInput, aliases };
+}
+/** Epoch milliseconds → "YYYY-MM-DD" (or full ISO when a time is present). */
+function epochToDateString(ms) {
+    const iso = new Date(ms).toISOString();
+    return iso.endsWith('T00:00:00.000Z') ? iso.slice(0, 10) : iso;
+}
+/**
+ * Turns the API's alias/union-value entries into one flat, friendly object
+ * per result row, keyed by the plan's output keys.
+ */
+function parseAggregateResults(response, aliases) {
+    const planByAlias = new Map(aliases.map((entry) => [entry.alias, entry]));
+    const results = response.aggregate?.results ?? [];
+    return results.map((resultSet) => {
+        const row = {};
+        // Seed in plan order so output keys keep the UI's ordering.
+        for (const entry of aliases) {
+            row[entry.outputKey] = null;
+        }
+        for (const entry of resultSet.entries ?? []) {
+            const plan = entry.alias ? planByAlias.get(entry.alias) : undefined;
+            if (!plan)
+                continue;
+            // The union carries either { result: Float } or { value: JSON }.
+            const raw = entry.value?.result !== undefined ? entry.value.result : entry.value?.value;
+            let value = raw === undefined ? null : raw;
+            if (plan.isLabel && value === '') {
+                // LABEL returns "" for items with no label set.
+                value = null;
+            }
+            if (plan.isDate && typeof value === 'number') {
+                value = epochToDateString(value);
+            }
+            row[plan.outputKey] = value;
+        }
+        return row;
+    });
+}
+//# sourceMappingURL=aggregate.js.map

package/dist/nodes/MondayCom/V2/helpers/aggregate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["../../../../../nodes/MondayCom/V2/helpers/aggregate.ts"],"names":[],"mappings":"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"}

package/dist/nodes/MondayCom/V2/helpers/boardLocator.d.ts

@@ -0,0 +1,48 @@
+import type { ILoadOptionsFunctions, INode, INodeListSearchResult, INodeProperties } from 'n8n-workflow';
+import { NodeOperationError } from 'n8n-workflow';
+/**
+ * Shared Board selector: the CRITICAL SCALE PATTERN for this package.
+ * Two modes — From List (searchable, paginated, capped) and By ID. A board
+ * URL carries no information beyond the ID it embeds, so pasting URLs is
+ * not offered — it would only add a parsing failure mode.
+ * Never enumerates an account: with no filter typed, the list mode pages
+ * 50 recently-used boards at a time; a typed filter switches to the
+ * cross-entity search API (search.boards), which matches server-side
+ * across the whole account.
+ */
+export declare const boardResourceLocator: INodeProperties;
+/**
+ * The error every board-scoped read throws when `boards(ids:)` comes back
+ * empty. monday answers an unknown or inaccessible board ID with an empty
+ * list, not an error, so without this a typo looks like an empty board.
+ */
+export declare function boardNotFoundError(node: INode, boardId: string, itemIndex: number): NodeOperationError;
+/**
+ * The boards query also returns monday docs (type "document") and subitem
+ * boards (type "sub_items_board"). Only real boards belong in board lists.
+ */
+export declare function isRealBoard(board: {
+    type?: string;
+}): boolean;
+/**
+ * The one way board options are labeled everywhere in this package:
+ * "Board (Workspace)". Dropdowns can't render a second row, and putting the
+ * workspace in the name also makes it searchable in every picker.
+ */
+export declare function formatBoardLabel(board: {
+    name: string;
+    workspace?: {
+        name?: string;
+    } | null;
+}): string;
+/**
+ * listSearch method for the From List mode — hybrid:
+ * - No filter → browse mode: pages through active boards (most recently
+ *   used first), 50 per request; n8n asks for the next page via
+ *   paginationToken as the user scrolls.
+ * - Filter typed → server-side search across the whole account via
+ *   search.boards (searchBoardsViaSearchApi above), so boards beyond the
+ *   recently-used window are still findable on big accounts.
+ */
+export declare function searchBoards(this: ILoadOptionsFunctions, filter?: string, paginationToken?: string): Promise<INodeListSearchResult>;
+//# sourceMappingURL=boardLocator.d.ts.map

package/dist/nodes/MondayCom/V2/helpers/boardLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boardLocator.d.ts","sourceRoot":"","sources":["../../../../../nodes/MondayCom/V2/helpers/boardLocator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,qBAAqB,EACrB,KAAK,EACL,qBAAqB,EACrB,eAAe,EACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAKlD;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAiClC,CAAC;AAYF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,sBAMjF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACrC,GAAG,MAAM,CAET;AAuDD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CACjC,IAAI,EAAE,qBAAqB,EAC3B,MAAM,CAAC,EAAE,MAAM,EACf,eAAe,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAqChC"}