n8n-nodes-base 2.21.2 → 2.22.0

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v44/resource_sheet/operation_append_or_update.ts

@@ -16,25 +16,50 @@ interface Credentials {
 
 /** Append a new row or update an existing one (upsert) */
 export type GoogleSheetsV44SheetAppendOrUpdateParams = {
+  /**
+   * <patterns>
+   * <pattern title="autoMapInputData — maps $json fields to sheet columns automatically">
+   * columns: {
+   *   mappingMode: 'autoMapInputData',
+   *   value: {},
+   *   schema: [
+   *     { id: 'Name', displayName: 'Name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'Email', displayName: 'Email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: false }
+   *   ]
+   * }
+   * </pattern>
+   * <pattern title="defineBelow — explicit expression mapping">
+   * columns: {
+   *   mappingMode: 'defineBelow',
+   *   value: { name: expr('{{ $json.name }}'), email: expr('{{ $json.email }}') },
+   *   schema: [
+   *     { id: 'name', displayName: 'name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'email', displayName: 'email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true }
+   *   ]
+   * }
+   * </pattern>
+   * </patterns>
+   */
   resource: 'sheet';
   operation: 'appendOrUpdate';
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */
     sheetName?: { __rl: true; mode: 'list' | 'url' | 'id' | 'name'; value: string; cachedResultName?: string };
 /**
  * Columns
+ * @builderHint Pass the full resourceMapper object: { mappingMode, value, schema, matchingColumns }. `matchingColumns` is REQUIRED for this operation — it must be a non-empty `string[]` of header names that uniquely identify the row to update; without it the node throws 'Could not get parameter' at runtime. Use the `append` operation instead if there is no key column to match on. A bare string like 'autoMapInputData' silently fails validation; always send the full resourceMapper object.
  * @displayOptions.hide { sheetName: [""] }
  * @default {"mappingMode":"defineBelow","value":null}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v44/resource_sheet/operation_clear.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV44SheetClearParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v44/resource_sheet/operation_create.ts

@@ -16,7 +16,7 @@ export type GoogleSheetsV44SheetCreateParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v44/resource_sheet/operation_delete.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV44SheetDeleteParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v44/resource_sheet/operation_read.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV44SheetReadParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v44/resource_sheet/operation_remove.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV44SheetRemoveParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v44/resource_sheet/operation_update.ts

@@ -16,25 +16,50 @@ interface Credentials {
 
 /** Update an existing row in a sheet */
 export type GoogleSheetsV44SheetUpdateParams = {
+  /**
+   * <patterns>
+   * <pattern title="autoMapInputData — maps $json fields to sheet columns automatically">
+   * columns: {
+   *   mappingMode: 'autoMapInputData',
+   *   value: {},
+   *   schema: [
+   *     { id: 'Name', displayName: 'Name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'Email', displayName: 'Email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: false }
+   *   ]
+   * }
+   * </pattern>
+   * <pattern title="defineBelow — explicit expression mapping">
+   * columns: {
+   *   mappingMode: 'defineBelow',
+   *   value: { name: expr('{{ $json.name }}'), email: expr('{{ $json.email }}') },
+   *   schema: [
+   *     { id: 'name', displayName: 'name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'email', displayName: 'email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true }
+   *   ]
+   * }
+   * </pattern>
+   * </patterns>
+   */
   resource: 'sheet';
   operation: 'update';
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */
     sheetName?: { __rl: true; mode: 'list' | 'url' | 'id' | 'name'; value: string; cachedResultName?: string };
 /**
  * Columns
+ * @builderHint Pass the full resourceMapper object: { mappingMode, value, schema, matchingColumns }. `matchingColumns` is REQUIRED for this operation — it must be a non-empty `string[]` of header names that uniquely identify the row to update; without it the node throws 'Could not get parameter' at runtime. Use the `append` operation instead if there is no key column to match on. A bare string like 'autoMapInputData' silently fails validation; always send the full resourceMapper object.
  * @displayOptions.hide { sheetName: [""] }
  * @default {"mappingMode":"defineBelow","value":null}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v45/resource_sheet/operation_append.ts

@@ -16,25 +16,50 @@ interface Credentials {
 
 /** Create a new row in a sheet */
 export type GoogleSheetsV45SheetAppendParams = {
+  /**
+   * <patterns>
+   * <pattern title="autoMapInputData — maps $json fields to sheet columns automatically">
+   * columns: {
+   *   mappingMode: 'autoMapInputData',
+   *   value: {},
+   *   schema: [
+   *     { id: 'Name', displayName: 'Name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'Email', displayName: 'Email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: false }
+   *   ]
+   * }
+   * </pattern>
+   * <pattern title="defineBelow — explicit expression mapping">
+   * columns: {
+   *   mappingMode: 'defineBelow',
+   *   value: { name: expr('{{ $json.name }}'), email: expr('{{ $json.email }}') },
+   *   schema: [
+   *     { id: 'name', displayName: 'name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'email', displayName: 'email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true }
+   *   ]
+   * }
+   * </pattern>
+   * </patterns>
+   */
   resource: 'sheet';
   operation: 'append';
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */
     sheetName?: { __rl: true; mode: 'list' | 'url' | 'id' | 'name'; value: string; cachedResultName?: string };
 /**
  * Columns
+ * @builderHint Pass the full resourceMapper object: { mappingMode, value, schema }. A bare string like 'autoMapInputData' fails validation. `append` is plain insert — do NOT add `matchingColumns` here (that is for the `appendOrUpdate` and `update` operations).
  * @displayOptions.hide { sheetName: [""] }
  * @default {"mappingMode":"defineBelow","value":null}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v45/resource_sheet/operation_append_or_update.ts

@@ -16,25 +16,50 @@ interface Credentials {
 
 /** Append a new row or update an existing one (upsert) */
 export type GoogleSheetsV45SheetAppendOrUpdateParams = {
+  /**
+   * <patterns>
+   * <pattern title="autoMapInputData — maps $json fields to sheet columns automatically">
+   * columns: {
+   *   mappingMode: 'autoMapInputData',
+   *   value: {},
+   *   schema: [
+   *     { id: 'Name', displayName: 'Name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'Email', displayName: 'Email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: false }
+   *   ]
+   * }
+   * </pattern>
+   * <pattern title="defineBelow — explicit expression mapping">
+   * columns: {
+   *   mappingMode: 'defineBelow',
+   *   value: { name: expr('{{ $json.name }}'), email: expr('{{ $json.email }}') },
+   *   schema: [
+   *     { id: 'name', displayName: 'name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'email', displayName: 'email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true }
+   *   ]
+   * }
+   * </pattern>
+   * </patterns>
+   */
   resource: 'sheet';
   operation: 'appendOrUpdate';
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */
     sheetName?: { __rl: true; mode: 'list' | 'url' | 'id' | 'name'; value: string; cachedResultName?: string };
 /**
  * Columns
+ * @builderHint Pass the full resourceMapper object: { mappingMode, value, schema, matchingColumns }. `matchingColumns` is REQUIRED for this operation — it must be a non-empty `string[]` of header names that uniquely identify the row to update; without it the node throws 'Could not get parameter' at runtime. Use the `append` operation instead if there is no key column to match on. A bare string like 'autoMapInputData' silently fails validation; always send the full resourceMapper object.
  * @displayOptions.hide { sheetName: [""] }
  * @default {"mappingMode":"defineBelow","value":null}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v45/resource_sheet/operation_clear.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV45SheetClearParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v45/resource_sheet/operation_create.ts

@@ -16,7 +16,7 @@ export type GoogleSheetsV45SheetCreateParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v45/resource_sheet/operation_delete.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV45SheetDeleteParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v45/resource_sheet/operation_read.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV45SheetReadParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v45/resource_sheet/operation_remove.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV45SheetRemoveParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v45/resource_sheet/operation_update.ts

@@ -16,25 +16,50 @@ interface Credentials {
 
 /** Update an existing row in a sheet */
 export type GoogleSheetsV45SheetUpdateParams = {
+  /**
+   * <patterns>
+   * <pattern title="autoMapInputData — maps $json fields to sheet columns automatically">
+   * columns: {
+   *   mappingMode: 'autoMapInputData',
+   *   value: {},
+   *   schema: [
+   *     { id: 'Name', displayName: 'Name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'Email', displayName: 'Email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: false }
+   *   ]
+   * }
+   * </pattern>
+   * <pattern title="defineBelow — explicit expression mapping">
+   * columns: {
+   *   mappingMode: 'defineBelow',
+   *   value: { name: expr('{{ $json.name }}'), email: expr('{{ $json.email }}') },
+   *   schema: [
+   *     { id: 'name', displayName: 'name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'email', displayName: 'email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true }
+   *   ]
+   * }
+   * </pattern>
+   * </patterns>
+   */
   resource: 'sheet';
   operation: 'update';
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */
     sheetName?: { __rl: true; mode: 'list' | 'url' | 'id' | 'name'; value: string; cachedResultName?: string };
 /**
  * Columns
+ * @builderHint Pass the full resourceMapper object: { mappingMode, value, schema, matchingColumns }. `matchingColumns` is REQUIRED for this operation — it must be a non-empty `string[]` of header names that uniquely identify the row to update; without it the node throws 'Could not get parameter' at runtime. Use the `append` operation instead if there is no key column to match on. A bare string like 'autoMapInputData' silently fails validation; always send the full resourceMapper object.
  * @displayOptions.hide { sheetName: [""] }
  * @default {"mappingMode":"defineBelow","value":null}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v46/resource_sheet/operation_append.ts

@@ -16,25 +16,50 @@ interface Credentials {
 
 /** Create a new row in a sheet */
 export type GoogleSheetsV46SheetAppendParams = {
+  /**
+   * <patterns>
+   * <pattern title="autoMapInputData — maps $json fields to sheet columns automatically">
+   * columns: {
+   *   mappingMode: 'autoMapInputData',
+   *   value: {},
+   *   schema: [
+   *     { id: 'Name', displayName: 'Name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'Email', displayName: 'Email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: false }
+   *   ]
+   * }
+   * </pattern>
+   * <pattern title="defineBelow — explicit expression mapping">
+   * columns: {
+   *   mappingMode: 'defineBelow',
+   *   value: { name: expr('{{ $json.name }}'), email: expr('{{ $json.email }}') },
+   *   schema: [
+   *     { id: 'name', displayName: 'name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'email', displayName: 'email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true }
+   *   ]
+   * }
+   * </pattern>
+   * </patterns>
+   */
   resource: 'sheet';
   operation: 'append';
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */
     sheetName?: { __rl: true; mode: 'list' | 'url' | 'id' | 'name'; value: string; cachedResultName?: string };
 /**
  * Columns
+ * @builderHint Pass the full resourceMapper object: { mappingMode, value, schema }. A bare string like 'autoMapInputData' fails validation. `append` is plain insert — do NOT add `matchingColumns` here (that is for the `appendOrUpdate` and `update` operations).
  * @displayOptions.hide { sheetName: [""] }
  * @default {"mappingMode":"defineBelow","value":null}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v46/resource_sheet/operation_append_or_update.ts

@@ -16,25 +16,50 @@ interface Credentials {
 
 /** Append a new row or update an existing one (upsert) */
 export type GoogleSheetsV46SheetAppendOrUpdateParams = {
+  /**
+   * <patterns>
+   * <pattern title="autoMapInputData — maps $json fields to sheet columns automatically">
+   * columns: {
+   *   mappingMode: 'autoMapInputData',
+   *   value: {},
+   *   schema: [
+   *     { id: 'Name', displayName: 'Name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'Email', displayName: 'Email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: false }
+   *   ]
+   * }
+   * </pattern>
+   * <pattern title="defineBelow — explicit expression mapping">
+   * columns: {
+   *   mappingMode: 'defineBelow',
+   *   value: { name: expr('{{ $json.name }}'), email: expr('{{ $json.email }}') },
+   *   schema: [
+   *     { id: 'name', displayName: 'name', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true },
+   *     { id: 'email', displayName: 'email', required: false, defaultMatch: false, display: true, type: 'string', canBeUsedToMatch: true }
+   *   ]
+   * }
+   * </pattern>
+   * </patterns>
+   */
   resource: 'sheet';
   operation: 'appendOrUpdate';
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */
     sheetName?: { __rl: true; mode: 'list' | 'url' | 'id' | 'name'; value: string; cachedResultName?: string };
 /**
  * Columns
+ * @builderHint Pass the full resourceMapper object: { mappingMode, value, schema, matchingColumns }. `matchingColumns` is REQUIRED for this operation — it must be a non-empty `string[]` of header names that uniquely identify the row to update; without it the node throws 'Could not get parameter' at runtime. Use the `append` operation instead if there is no key column to match on. A bare string like 'autoMapInputData' silently fails validation; always send the full resourceMapper object.
  * @displayOptions.hide { sheetName: [""] }
  * @default {"mappingMode":"defineBelow","value":null}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v46/resource_sheet/operation_clear.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV46SheetClearParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v46/resource_sheet/operation_create.ts

@@ -16,7 +16,7 @@ export type GoogleSheetsV46SheetCreateParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v46/resource_sheet/operation_delete.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV46SheetDeleteParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v46/resource_sheet/operation_read.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV46SheetReadParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */

package/dist/node-definitions/nodes/n8n-nodes-base/googleSheets/v46/resource_sheet/operation_remove.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV46SheetRemoveParams = {
   authentication?: 'serviceAccount' | 'oAuth2' | Expression<string>;
 /**
  * Document
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod spreadSheetsSearch
  * @default {"mode":"list","value":""}
  */
     documentId?: { __rl: true; mode: 'list' | 'url' | 'id'; value: string; cachedResultName?: string };
 /**
  * Sheet
- * @builderHint Default to mode: 'list' which is easier for users to set up
+ * @builderHint Default to mode: 'list' which is easier for users to set up. Resource locator value must be `{ __rl: true, mode, value }` — never a plain string or `expr()` wrapper.
  * @searchListMethod sheetsSearch
  * @default {"mode":"list","value":""}
  */