n8n-nodes-base 2.21.2 → 2.22.0

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

@@ -16,19 +16,43 @@ interface Credentials {
 
 /** Append a new row or update an existing one (upsert) */
 export type GoogleSheetsV3SheetAppendOrUpdateParams = {
+  /**
+   * <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":""}
  */
@@ -77,6 +101,7 @@ export type GoogleSheetsV3SheetAppendOrUpdateParams = {
   };
 /**
  * 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/v3/resource_sheet/operation_clear.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV3SheetClearParams = {
   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/v3/resource_sheet/operation_create.ts

@@ -16,7 +16,7 @@ export type GoogleSheetsV3SheetCreateParams = {
   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/v3/resource_sheet/operation_delete.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV3SheetDeleteParams = {
   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/v3/resource_sheet/operation_read.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV3SheetReadParams = {
   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/v3/resource_sheet/operation_remove.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV3SheetRemoveParams = {
   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/v3/resource_sheet/operation_update.ts

@@ -16,19 +16,43 @@ interface Credentials {
 
 /** Update an existing row in a sheet */
 export type GoogleSheetsV3SheetUpdateParams = {
+  /**
+   * <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":""}
  */
@@ -77,6 +101,7 @@ export type GoogleSheetsV3SheetUpdateParams = {
   };
 /**
  * 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/v4/resource_sheet/operation_append.ts

@@ -16,25 +16,50 @@ interface Credentials {
 
 /** Create a new row in a sheet */
 export type GoogleSheetsV4SheetAppendParams = {
+  /**
+   * <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/v4/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 GoogleSheetsV4SheetAppendOrUpdateParams = {
+  /**
+   * <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/v4/resource_sheet/operation_clear.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV4SheetClearParams = {
   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/v4/resource_sheet/operation_create.ts

@@ -16,7 +16,7 @@ export type GoogleSheetsV4SheetCreateParams = {
   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/v4/resource_sheet/operation_delete.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV4SheetDeleteParams = {
   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/v4/resource_sheet/operation_read.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV4SheetReadParams = {
   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/v4/resource_sheet/operation_remove.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV4SheetRemoveParams = {
   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/v4/resource_sheet/operation_update.ts

@@ -16,25 +16,50 @@ interface Credentials {
 
 /** Update an existing row in a sheet */
 export type GoogleSheetsV4SheetUpdateParams = {
+  /**
+   * <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/v41/resource_sheet/operation_append.ts

@@ -16,25 +16,50 @@ interface Credentials {
 
 /** Create a new row in a sheet */
 export type GoogleSheetsV41SheetAppendParams = {
+  /**
+   * <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/v41/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 GoogleSheetsV41SheetAppendOrUpdateParams = {
+  /**
+   * <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/v41/resource_sheet/operation_clear.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV41SheetClearParams = {
   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/v41/resource_sheet/operation_create.ts

@@ -16,7 +16,7 @@ export type GoogleSheetsV41SheetCreateParams = {
   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/v41/resource_sheet/operation_delete.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV41SheetDeleteParams = {
   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/v41/resource_sheet/operation_read.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV41SheetReadParams = {
   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/v41/resource_sheet/operation_remove.ts

@@ -16,14 +16,14 @@ export type GoogleSheetsV41SheetRemoveParams = {
   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":""}
  */