n8n-nodes-base 2.44.1 → 2.45.0

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

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.itemIdTextProperty = exports.HIDE_UNTIL_BOARD_SELECTED = exports.itemListOnlyResourceLocator = exports.itemInputModeProperty = exports.itemResourceLocator = void 0;
+exports.formatItemSearchLabel = formatItemSearchLabel;
+exports.searchItems = searchItems;
+const accountSearch_1 = require("./accountSearch");
+const MondayGraphQLClient_1 = require("../transport/MondayGraphQLClient");
+/**
+ * Shared Item selector, dependent on the board selected in the `boardId`
+ * parameter. Boards can hold millions of items, so From List NEVER dumps the
+ * whole board: without a search term it shows the first page of items, and
+ * a typed search term goes to the cross-entity search API (search.items
+ * scoped by board_ids) — fuzzy, relevance-ranked matching instead of a
+ * literal contains_text rule. Search results are capped at 20 by the API
+ * (top-N by relevance, no pagination); typing a more specific term narrows
+ * the candidates.
+ */
+exports.itemResourceLocator = {
+    displayName: 'Item',
+    name: 'itemId',
+    type: 'resourceLocator',
+    default: { mode: 'list', value: '' },
+    required: true,
+    description: 'The item to operate on',
+    modes: [
+        {
+            displayName: 'From List',
+            name: 'list',
+            type: 'list',
+            typeOptions: {
+                searchListMethod: 'searchItems',
+                searchable: true,
+            },
+        },
+        {
+            displayName: 'By ID',
+            name: 'id',
+            type: 'string',
+            placeholder: 'e.g. 1234567890',
+        },
+    ],
+};
+/**
+ * Item selection mode switch for item-only operations (Update: Create,
+ * Item: Get, Item: Get Subscribers, Update: Get Many, Notification:
+ * Create). Item IDs are globally unique, so the board picker exists purely
+ * to power the From List item search — By Item ID skips it entirely.
+ * Declared per operation group with matching displayOptions.
+ */
+exports.itemInputModeProperty = {
+    displayName: 'Item Input',
+    name: 'itemInputMode',
+    type: 'options',
+    noDataExpression: true,
+    options: [
+        {
+            name: 'By Item ID',
+            value: 'id',
+            description: 'Provide the item ID directly — no board selection needed',
+        },
+        {
+            name: 'From Board',
+            value: 'list',
+            description: 'Pick a board, then pick the item from its list',
+        },
+    ],
+    default: 'id',
+    description: 'How to choose the item',
+};
+/** The item selector reduced to its From List mode — paired with a board
+ * picker when itemInputMode is "list". */
+exports.itemListOnlyResourceLocator = {
+    ...exports.itemResourceLocator,
+    modes: exports.itemResourceLocator.modes.filter((mode) => mode.name === 'list'),
+};
+/**
+ * Progressive disclosure for the From Board path: keep the item picker
+ * hidden until a board is chosen, because searchItems needs `boardId` and
+ * would otherwise open to a "Parameter Board is required" error. Paired
+ * with `itemListOnlyResourceLocator` only — a locator that also offers By
+ * ID must stay visible, since that mode needs no board.
+ *
+ * displayOptions unwraps a resourceLocator to its `.value`, so `['']`
+ * matches the unselected picker. Expressions (`=...`) don't match and stay
+ * visible.
+ */
+exports.HIDE_UNTIL_BOARD_SELECTED = { boardId: [''] };
+/**
+ * The By Item ID field: a plain text input, not a one-mode resourceLocator
+ * (which the UI still renders as a picker with a mode dropdown). Keeps the
+ * `itemId` name so execution code reads the same parameter either way.
+ */
+exports.itemIdTextProperty = {
+    displayName: 'Item ID',
+    name: 'itemId',
+    type: 'string',
+    default: '',
+    required: true,
+    placeholder: 'e.g. 1234567890',
+    description: 'The ID of the item to operate on',
+};
+const ITEM_SEARCH_PAGE_SIZE = 50;
+/** Labels subitems by their parent so nested rows are distinguishable. */
+function formatItemSearchLabel(item) {
+    if (item.parent_item?.name)
+        return `${item.name} (subitem of ${item.parent_item.name})`;
+    return item.group?.title ? `${item.name} (${item.group.title})` : item.name;
+}
+/**
+ * Search path: one search.items request scoped to the selected board,
+ * relevance-ordered and fuzzy (contextual matching, not just contains).
+ * Hard-capped at 20 results with no pagination (per the search API
+ * reference) — a more specific term surfaces what the cap hides. Rows with
+ * null live_data (deleted, inaccessible, or index lag) are kept on their
+ * indexed_data name — the item may well be selectable, and dropping it
+ * would hide legitimate results. Subitems come back too (they are indexed
+ * under the same board on multi-level boards), labeled via parent_item.
+ */
+async function searchItemsViaSearchApi(client, boardId, query) {
+    const data = await client.execute(`query ($q: String!, $limit: Int, $boardIds: [ID!]) {
+			search {
+				items(query: $q, limit: $limit, board_ids: $boardIds) {
+					results {
+						id
+						indexed_data { name }
+						live_data { id name group { title } parent_item { id name } }
+					}
+				}
+			}
+		}`, 0, { q: query, limit: accountSearch_1.SEARCH_MAX_LIMIT, boardIds: [boardId] });
+    const container = data.search
+        ?.items;
+    const results = (container?.results ?? []).map((result) => ({
+        name: result.live_data
+            ? formatItemSearchLabel(result.live_data)
+            : (result.indexed_data?.name ?? String(result.id)),
+        value: String(result.id),
+    }));
+    // No paginationToken: the search API returns top-N only.
+    return { results };
+}
+/**
+ * listSearch method for the item From List mode — hybrid, same pattern as
+ * searchBoards:
+ * - Filter typed → server-side fuzzy search across the selected board via
+ *   search.items (searchItemsViaSearchApi above), relevance-ranked.
+ * - No filter → browse mode: the first page of the board's items via
+ *   items_page, so the picker never dumps a whole board.
+ *
+ * Multi-level boards keep items and subitems on ONE board; in browse mode
+ * the list also covers subitems there (hierarchy_scope_config: "allItems")
+ * — needed e.g. to pick a nested parent for Create → Subitem. The
+ * all-items scope requires at least one rule (unfiltered it returns an
+ * empty page — verified API bug), so browse matches every group. On the
+ * search path subitems ride along in the search results themselves.
+ */
+async function searchItems(filter) {
+    const boardId = this.getCurrentNodeParameter('boardId', { extractValue: true });
+    if (!boardId) {
+        return { results: [] };
+    }
+    const client = new MondayGraphQLClient_1.MondayGraphQLClient(this);
+    const query = filter?.trim();
+    if (query) {
+        return await searchItemsViaSearchApi(client, boardId, query);
+    }
+    const data = await client.execute(`query ($ids: [ID!], $limit: Int!, $queryParams: ItemsQuery) {
+			boards(ids: $ids) {
+				hierarchy_type
+				groups { id }
+				items_page(limit: $limit, query_params: $queryParams) {
+					items { id name group { title } }
+				}
+			}
+		}`, 0, {
+        ids: [boardId],
+        limit: ITEM_SEARCH_PAGE_SIZE,
+        queryParams: null,
+    });
+    const boards = (data.boards ?? []);
+    let items = boards[0]?.items_page?.items ?? [];
+    if (boards[0]?.hierarchy_type === 'multi_level') {
+        const groupIds = (boards[0].groups ?? []).map((group) => group.id);
+        const rule = {
+            column_id: 'group',
+            compare_value: groupIds,
+            operator: 'any_of',
+        };
+        const scoped = await client.execute(`query ($ids: [ID!], $limit: Int!, $queryParams: ItemsQuery) {
+				boards(ids: $ids) {
+					items_page(limit: $limit, query_params: $queryParams, hierarchy_scope_config: "allItems") {
+						items { id name group { title } parent_item { id name } }
+					}
+				}
+			}`, 0, { ids: [boardId], limit: ITEM_SEARCH_PAGE_SIZE, queryParams: { rules: [rule] } });
+        const scopedBoards = (scoped.boards ?? []);
+        items = scopedBoards[0]?.items_page?.items ?? items;
+    }
+    return {
+        results: items.map((item) => ({
+            name: formatItemSearchLabel(item),
+            value: item.id,
+        })),
+    };
+}
+//# sourceMappingURL=itemLocator.js.map

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

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

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

@@ -0,0 +1,90 @@
+import type { IDataObject } from 'n8n-workflow';
+import type { MondayGraphQLClient } from '../transport/MondayGraphQLClient';
+/**
+ * Shared multi-level board support (hierarchy_type: multi_level — Portfolio
+ * Project boards with up to five subitem levels). Key API facts, all
+ * verified live on the pinned version:
+ *
+ * - All items and subitems share ONE board (and one column schema); the
+ *   main board ID is used for every mutation at any depth.
+ * - Rollup-capable column values are OMITTED from column_values unless the
+ *   query passes `capabilities: [CALCULATED]` (harmless on classic boards).
+ * - Status columns with rollup resolve to BatteryValue, not StatusValue,
+ *   on every item — including leaves.
+ * - `hierarchy_scope_config: "allItems"` on items_page returns the whole
+ *   hierarchy flat, but silently ignores order_by, and returns NOTHING when
+ *   no query_params rules are set (API bug) — callers must inject a
+ *   tautological all-groups rule.
+ */
+export type BoardHierarchyType = 'classic' | 'multi_level';
+/** Resolves a board's hierarchy type with one bounded query (cached per execution). */
+export declare function getBoardHierarchyType(client: MondayGraphQLClient, itemIndex: number, boardId: string): Promise<BoardHierarchyType>;
+/**
+ * Arguments every item column_values read should pass: without CALCULATED,
+ * rollup-capable columns are silently absent from the response on
+ * multi-level boards (verified live — not even empty entries). On classic
+ * boards the argument changes nothing.
+ */
+export declare const COLUMN_VALUES_CALCULATED_ARG = "capabilities: [CALCULATED]";
+/**
+ * Fragment for status rollup values, which resolve to BatteryValue instead
+ * of StatusValue on multi-level boards (on ALL items, including leaves).
+ * `is_leaf: false` marks a calculated rollup; `true` marks a static value.
+ * Never matches on classic boards, so it's safe to request everywhere.
+ */
+export declare const BATTERY_VALUE_FRAGMENT = "... on BatteryValue { battery_value { key count } is_leaf }";
+/**
+ * Fragments for the linked-item column value types whose `text` and `value`
+ * are ALWAYS null in the API (verified live on 2026-07): dependency,
+ * board_relation (connect boards) and mirror. `display_value` carries the
+ * comma-separated linked item names, `linked_item_ids` the IDs. Both are
+ * scalar fields — cheap enough to request on every item read, including
+ * Get Many at high limits. Full `linked_items` objects are deliberately NOT
+ * here (per-row complexity); Item: Get Column Value requests them via
+ * LINKED_VALUE_DETAIL_FRAGMENTS instead.
+ */
+export declare const LINKED_VALUE_FRAGMENTS: string;
+/**
+ * The rich variant for single-column reads (Item: Get Column Value — one
+ * item, one column, bounded): adds the linked items' names and, for
+ * dependency columns, the per-link metadata. `dependency_links` IS exposed
+ * on the pinned 2026-07 schema (dependency_type 0=FS/1=SS/2=FF/3=SF, lag in
+ * days — null for plain links); the public doc's "not exposed by the API"
+ * callout is stale.
+ */
+export declare const LINKED_VALUE_DETAIL_FRAGMENTS: string;
+export interface BatteryEntry {
+    key?: string | number;
+    count?: number;
+}
+/**
+ * Formats a BatteryValue for flattened output: "Done: 2, Working on it: 1".
+ * Label keys are indexes into the column's status labels; unknown keys stay
+ * as "label <key>" so nothing is silently dropped.
+ */
+export declare function formatBatteryText(entries: BatteryEntry[] | null | undefined, settingsStr?: string): string | null;
+/**
+ * Tautological items_page rule matching every group — the verified
+ * workaround for the API bug where `hierarchy_scope_config: "allItems"`
+ * returns an empty page when no query_params rules are set at all.
+ */
+export declare function buildAllGroupsRule(groupIds: string[]): IDataObject;
+/** Fetches the board's group IDs (bounded — one call) for buildAllGroupsRule. */
+export declare function fetchBoardGroupIds(client: MondayGraphQLClient, itemIndex: number, boardId: string): Promise<string[]>;
+/** Rollup functions each column type supports (CalculatedFunction enum). */
+export declare const ROLLUP_FUNCTIONS_BY_COLUMN_TYPE: Record<string, readonly string[]>;
+/**
+ * Validates a picked rollup function against the column type. Returns an
+ * error message, or null when the combination is valid.
+ */
+export declare function validateRollupFunction(columnType: string, rollupFunction: string): string | null;
+/**
+ * The user-facing note attached to aggregate results on multi-level boards.
+ * Verified live: as soon as the query reads any column (a column-based
+ * calculation or a grouping), the aggregation engine scans LEAF items only —
+ * including Count Items in the same query. A pure Count Items query (no
+ * column reads anywhere) counts ALL items at every depth. There is no API
+ * control to change either scope.
+ */
+export declare const MULTI_LEVEL_AGGREGATE_NOTE = "This is a multi-level board. Calculations and groupings that read a board column cover LEAF items only (items without subitems, at any depth) \u2014 values stored on parent items are excluded, and rollup columns aggregate their leaf values. Count Items covers all items (parents and subitems) only while the query reads no board column (the item name does not count); combined with a column-based calculation or grouping it also becomes leaf-only.";
+//# sourceMappingURL=multiLevel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"multiLevel.d.ts","sourceRoot":"","sources":["../../../../../nodes/MondayCom/V2/helpers/multiLevel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,aAAa,CAAC;AAS3D,uFAAuF;AACvF,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,CAAC,CAmB7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,+BAA+B,CAAC;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,gEAAgE,CAAC;AAEpG;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,QAGI,CAAC;AAExC;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,QAGH,CAAC;AAExC,MAAM,WAAW,YAAY;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAsBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,GAAG,SAAS,EAC1C,WAAW,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAUf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,CAElE;AAED,iFAAiF;AACjF,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB;AAED,4EAA4E;AAC5E,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAK7E,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAShG;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,ocACsZ,CAAC"}

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

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MULTI_LEVEL_AGGREGATE_NOTE = exports.ROLLUP_FUNCTIONS_BY_COLUMN_TYPE = exports.LINKED_VALUE_DETAIL_FRAGMENTS = exports.LINKED_VALUE_FRAGMENTS = exports.BATTERY_VALUE_FRAGMENT = exports.COLUMN_VALUES_CALCULATED_ARG = void 0;
+exports.getBoardHierarchyType = getBoardHierarchyType;
+exports.formatBatteryText = formatBatteryText;
+exports.buildAllGroupsRule = buildAllGroupsRule;
+exports.fetchBoardGroupIds = fetchBoardGroupIds;
+exports.validateRollupFunction = validateRollupFunction;
+/**
+ * A board's hierarchy_type never changes (there is no classic ⇄ multi-level
+ * conversion), so results are cached per client instance — one instance per
+ * node execution, so the cache cannot outlive a run.
+ */
+const hierarchyCache = new WeakMap();
+/** Resolves a board's hierarchy type with one bounded query (cached per execution). */
+async function getBoardHierarchyType(client, itemIndex, boardId) {
+    let cache = hierarchyCache.get(client);
+    if (!cache) {
+        cache = new Map();
+        hierarchyCache.set(client, cache);
+    }
+    const cached = cache.get(boardId);
+    if (cached)
+        return cached;
+    const data = await client.execute('query ($ids: [ID!]) { boards(ids: $ids) { id hierarchy_type } }', itemIndex, { ids: [boardId] });
+    const boards = (data.boards ?? []);
+    const hierarchyType = boards[0]?.hierarchy_type === 'multi_level' ? 'multi_level' : 'classic';
+    cache.set(boardId, hierarchyType);
+    return hierarchyType;
+}
+/**
+ * Arguments every item column_values read should pass: without CALCULATED,
+ * rollup-capable columns are silently absent from the response on
+ * multi-level boards (verified live — not even empty entries). On classic
+ * boards the argument changes nothing.
+ */
+exports.COLUMN_VALUES_CALCULATED_ARG = 'capabilities: [CALCULATED]';
+/**
+ * Fragment for status rollup values, which resolve to BatteryValue instead
+ * of StatusValue on multi-level boards (on ALL items, including leaves).
+ * `is_leaf: false` marks a calculated rollup; `true` marks a static value.
+ * Never matches on classic boards, so it's safe to request everywhere.
+ */
+exports.BATTERY_VALUE_FRAGMENT = '... on BatteryValue { battery_value { key count } is_leaf }';
+/**
+ * Fragments for the linked-item column value types whose `text` and `value`
+ * are ALWAYS null in the API (verified live on 2026-07): dependency,
+ * board_relation (connect boards) and mirror. `display_value` carries the
+ * comma-separated linked item names, `linked_item_ids` the IDs. Both are
+ * scalar fields — cheap enough to request on every item read, including
+ * Get Many at high limits. Full `linked_items` objects are deliberately NOT
+ * here (per-row complexity); Item: Get Column Value requests them via
+ * LINKED_VALUE_DETAIL_FRAGMENTS instead.
+ */
+exports.LINKED_VALUE_FRAGMENTS = '... on DependencyValue { display_value linked_item_ids } ' +
+    '... on BoardRelationValue { display_value linked_item_ids } ' +
+    '... on MirrorValue { display_value }';
+/**
+ * The rich variant for single-column reads (Item: Get Column Value — one
+ * item, one column, bounded): adds the linked items' names and, for
+ * dependency columns, the per-link metadata. `dependency_links` IS exposed
+ * on the pinned 2026-07 schema (dependency_type 0=FS/1=SS/2=FF/3=SF, lag in
+ * days — null for plain links); the public doc's "not exposed by the API"
+ * callout is stale.
+ */
+exports.LINKED_VALUE_DETAIL_FRAGMENTS = '... on DependencyValue { display_value linked_item_ids linked_items { id name } dependency_links { linked_item_id dependency_type lag } } ' +
+    '... on BoardRelationValue { display_value linked_item_ids linked_items { id name } } ' +
+    '... on MirrorValue { display_value }';
+/**
+ * Builds a status label index → text map from a status column's
+ * settings_str ({"labels": {"0": "Done", ...}}).
+ */
+function parseLabelTextByIndex(settingsStr) {
+    if (!settingsStr)
+        return {};
+    try {
+        const settings = JSON.parse(settingsStr);
+        const labels = settings.labels;
+        if (labels && typeof labels === 'object' && !Array.isArray(labels)) {
+            return Object.fromEntries(Object.entries(labels).filter(([, text]) => typeof text === 'string' && text !== ''));
+        }
+    }
+    catch {
+        // Malformed settings — fall back to raw label keys.
+    }
+    return {};
+}
+/**
+ * Formats a BatteryValue for flattened output: "Done: 2, Working on it: 1".
+ * Label keys are indexes into the column's status labels; unknown keys stay
+ * as "label <key>" so nothing is silently dropped.
+ */
+function formatBatteryText(entries, settingsStr) {
+    if (!entries || entries.length === 0)
+        return null;
+    const labelByIndex = parseLabelTextByIndex(settingsStr);
+    return entries
+        .map((entry) => {
+        const key = String(entry.key ?? '');
+        const label = labelByIndex[key] ?? `label ${key}`;
+        return `${label}: ${entry.count ?? 0}`;
+    })
+        .join(', ');
+}
+/**
+ * Tautological items_page rule matching every group — the verified
+ * workaround for the API bug where `hierarchy_scope_config: "allItems"`
+ * returns an empty page when no query_params rules are set at all.
+ */
+function buildAllGroupsRule(groupIds) {
+    return { column_id: 'group', compare_value: groupIds, operator: 'any_of' };
+}
+/** Fetches the board's group IDs (bounded — one call) for buildAllGroupsRule. */
+async function fetchBoardGroupIds(client, itemIndex, boardId) {
+    const data = await client.execute('query ($ids: [ID!]) { boards(ids: $ids) { groups { id } } }', itemIndex, { ids: [boardId] });
+    const boards = (data.boards ?? []);
+    return (boards[0]?.groups ?? []).map((group) => group.id);
+}
+/** Rollup functions each column type supports (CalculatedFunction enum). */
+exports.ROLLUP_FUNCTIONS_BY_COLUMN_TYPE = {
+    numbers: ['SUM', 'MIN', 'MAX', 'NONE'],
+    date: ['MIN', 'MAX', 'NONE'],
+    timeline: ['MIN_MAX', 'NONE'],
+    status: ['COUNT_KEYS', 'NONE'],
+};
+/**
+ * Validates a picked rollup function against the column type. Returns an
+ * error message, or null when the combination is valid.
+ */
+function validateRollupFunction(columnType, rollupFunction) {
+    const allowed = exports.ROLLUP_FUNCTIONS_BY_COLUMN_TYPE[columnType];
+    if (!allowed) {
+        return `Rollup is not supported on ${columnType} columns — only numbers, date, timeline, and status columns can roll up child values`;
+    }
+    if (!allowed.includes(rollupFunction)) {
+        return `Rollup function ${rollupFunction} is not supported on ${columnType} columns (supported: ${allowed.join(', ')})`;
+    }
+    return null;
+}
+/**
+ * The user-facing note attached to aggregate results on multi-level boards.
+ * Verified live: as soon as the query reads any column (a column-based
+ * calculation or a grouping), the aggregation engine scans LEAF items only —
+ * including Count Items in the same query. A pure Count Items query (no
+ * column reads anywhere) counts ALL items at every depth. There is no API
+ * control to change either scope.
+ */
+exports.MULTI_LEVEL_AGGREGATE_NOTE = 'This is a multi-level board. Calculations and groupings that read a board column cover LEAF items only (items without subitems, at any depth) — values stored on parent items are excluded, and rollup columns aggregate their leaf values. Count Items covers all items (parents and subitems) only while the query reads no board column (the item name does not count); combined with a column-based calculation or grouping it also becomes leaf-only.';
+//# sourceMappingURL=multiLevel.js.map

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

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

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

@@ -0,0 +1,80 @@
+import type { IDataObject } from 'n8n-workflow';
+import type { MondayGraphQLClient } from '../transport/MondayGraphQLClient';
+/**
+ * Shared pagination helpers implementing the n8n Return All / Limit
+ * convention against monday's two pagination styles:
+ *
+ * - Page-based (`limit`/`page` args): boards, users, updates.
+ * - Cursor-based (`items_page` → `next_items_page`): items.
+ *
+ * Scale rules (see roadmap item "Cursor pagination + Return All handling"):
+ * - Results stream page by page — never one giant request.
+ * - Complexity budget is handled by MondayGraphQLClient, which retries with
+ *   monday's `retry_in_seconds` hint on ComplexityException / rate limits.
+ * - Return All is hard-capped so a 1M-record account cannot melt a workflow;
+ *   past the cap the caller gets the cap's worth of records.
+ */
+export declare const RETURN_ALL_HARD_CAP = 100000;
+/** Default records per request. Kept well under API maximums to control
+ * per-request complexity when callers select many fields. */
+export declare const DEFAULT_PAGE_SIZE = 100;
+export interface PageBasedOptions {
+    client: MondayGraphQLClient;
+    itemIndex: number;
+    /** Query that declares `$limit: Int!` and `$page: Int!` variables. */
+    query: string;
+    variables?: Record<string, unknown>;
+    /** Pull the array of rows out of one response payload. */
+    extractRows: (data: IDataObject) => IDataObject[];
+    /** Maximum records to return; undefined = Return All (hard-capped). */
+    limit?: number;
+    pageSize?: number;
+}
+/**
+ * Page-based pagination (boards, users, updates). Requests `$page` starting
+ * at 1 and stops when a page comes back short, the limit is reached, or the
+ * hard cap is hit.
+ */
+export declare function fetchAllPaged(options: PageBasedOptions): Promise<IDataObject[]>;
+export interface CursorPage {
+    cursor: string | null;
+    items: IDataObject[];
+}
+export interface CursorPageResult {
+    rows: IDataObject[];
+    /**
+     * Cursor for the next unfetched item, or null when the collection is
+     * exhausted. Valid for 60 minutes; feed it back via `startCursor` to
+     * resume exactly where this run stopped.
+     */
+    nextCursor: string | null;
+}
+export interface CursorBasedOptions {
+    client: MondayGraphQLClient;
+    itemIndex: number;
+    /** Query for the first page. Must declare a `$limit: Int!` variable. */
+    firstQuery: string;
+    firstVariables?: Record<string, unknown>;
+    /** Pull `{ cursor, items }` out of the first page's response payload. */
+    extractFirstPage: (data: IDataObject) => CursorPage | undefined;
+    /**
+     * GraphQL selection set for each item in follow-up `next_items_page`
+     * requests. Must match the fields selected in `firstQuery`.
+     */
+    itemFields: string;
+    /** Maximum records to return (hard-capped). */
+    limit?: number;
+    pageSize?: number;
+    /** Resume from a previous run's nextCursor instead of the first query. */
+    startCursor?: string;
+}
+/**
+ * Cursor-based pagination for items: first page via the caller's query
+ * (`items_page` under a board), follow-up pages via the top-level
+ * `next_items_page` until the cursor is exhausted or the limit is reached.
+ * Each request asks for exactly the remaining record budget, so the
+ * returned nextCursor always points at the first unfetched item — safe to
+ * resume from in a later run.
+ */
+export declare function fetchAllByCursor(options: CursorBasedOptions): Promise<CursorPageResult>;
+//# sourceMappingURL=pagination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../../../nodes/MondayCom/V2/helpers/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C;6DAC6D;AAC7D,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,0DAA0D;IAC1D,WAAW,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,WAAW,EAAE,CAAC;IAClD,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAuBrF;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,WAAW,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB;;;;OAIG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,yEAAyE;IACzE,gBAAgB,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,UAAU,GAAG,SAAS,CAAC;IAChE;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwC7F"}

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

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PAGE_SIZE = exports.RETURN_ALL_HARD_CAP = void 0;
+exports.fetchAllPaged = fetchAllPaged;
+exports.fetchAllByCursor = fetchAllByCursor;
+/**
+ * Shared pagination helpers implementing the n8n Return All / Limit
+ * convention against monday's two pagination styles:
+ *
+ * - Page-based (`limit`/`page` args): boards, users, updates.
+ * - Cursor-based (`items_page` → `next_items_page`): items.
+ *
+ * Scale rules (see roadmap item "Cursor pagination + Return All handling"):
+ * - Results stream page by page — never one giant request.
+ * - Complexity budget is handled by MondayGraphQLClient, which retries with
+ *   monday's `retry_in_seconds` hint on ComplexityException / rate limits.
+ * - Return All is hard-capped so a 1M-record account cannot melt a workflow;
+ *   past the cap the caller gets the cap's worth of records.
+ */
+exports.RETURN_ALL_HARD_CAP = 100000;
+/** Default records per request. Kept well under API maximums to control
+ * per-request complexity when callers select many fields. */
+exports.DEFAULT_PAGE_SIZE = 100;
+/**
+ * Page-based pagination (boards, users, updates). Requests `$page` starting
+ * at 1 and stops when a page comes back short, the limit is reached, or the
+ * hard cap is hit.
+ */
+async function fetchAllPaged(options) {
+    const { client, itemIndex, query, variables, extractRows } = options;
+    const max = Math.min(options.limit ?? exports.RETURN_ALL_HARD_CAP, exports.RETURN_ALL_HARD_CAP);
+    const pageSize = Math.min(options.pageSize ?? exports.DEFAULT_PAGE_SIZE, max);
+    const rows = [];
+    let page = 1;
+    while (rows.length < max) {
+        const data = await client.execute(query, itemIndex, {
+            ...variables,
+            limit: pageSize,
+            page,
+        });
+        const pageRows = extractRows(data);
+        rows.push(...pageRows);
+        // A short page means the collection is exhausted.
+        if (pageRows.length < pageSize)
+            break;
+        page += 1;
+    }
+    return rows.slice(0, max);
+}
+/**
+ * Cursor-based pagination for items: first page via the caller's query
+ * (`items_page` under a board), follow-up pages via the top-level
+ * `next_items_page` until the cursor is exhausted or the limit is reached.
+ * Each request asks for exactly the remaining record budget, so the
+ * returned nextCursor always points at the first unfetched item — safe to
+ * resume from in a later run.
+ */
+async function fetchAllByCursor(options) {
+    const { client, itemIndex, firstQuery, firstVariables, extractFirstPage, itemFields } = options;
+    const max = Math.min(options.limit ?? exports.RETURN_ALL_HARD_CAP, exports.RETURN_ALL_HARD_CAP);
+    const basePageSize = options.pageSize ?? exports.DEFAULT_PAGE_SIZE;
+    let rows = [];
+    let cursor;
+    if (options.startCursor) {
+        cursor = options.startCursor;
+    }
+    else {
+        const firstData = await client.execute(firstQuery, itemIndex, {
+            ...firstVariables,
+            limit: Math.min(basePageSize, max),
+        });
+        const firstPage = extractFirstPage(firstData);
+        if (!firstPage)
+            return { rows: [], nextCursor: null };
+        rows = [...firstPage.items];
+        cursor = firstPage.cursor;
+    }
+    while (cursor && rows.length < max) {
+        const data = await client.execute(`query ($cursor: String!, $limit: Int!) {
+				next_items_page(cursor: $cursor, limit: $limit) {
+					cursor
+					items { ${itemFields} }
+				}
+			}`, itemIndex, { cursor, limit: Math.min(basePageSize, max - rows.length) });
+        const nextPage = data.next_items_page;
+        if (!nextPage)
+            break;
+        rows.push(...nextPage.items);
+        cursor = nextPage.cursor;
+    }
+    return { rows: rows.slice(0, max), nextCursor: cursor ?? null };
+}
+//# sourceMappingURL=pagination.js.map

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

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