n8n-nodes-base 2.21.2 → 2.22.0

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

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

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

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

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

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

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

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

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

@@ -22,7 +22,7 @@ export interface GoogleSheetsTriggerV1Params {
        * @default 14
        */
       hour?: number | Expression<number>;
-      /** The minute of the day to trigger
+      /** The minute past the hour to trigger (0-59)
        * @displayOptions.hide { mode: ["custom", "everyMinute", "everyX"] }
        * @default 0
        */

package/dist/node-definitions/nodes/n8n-nodes-base/httpRequest/v3.ts

@@ -22,6 +22,12 @@ export interface HttpRequestV3Params {
     nodeCredentialType?: string;
 /**
  * Generic Auth Type
+ * @builderHint Pick by how the API authenticates, not by what the user calls it:
+- "Authorization: Bearer <token>" → httpBearerAuth (single token field, best UX). Use this for OpenAI, Anthropic, GitHub PATs, Stripe, Notion, and any service whose docs say "Bearer".
+- Custom header like X-API-Key, apikey, X-Auth-Token, or non-Bearer Authorization schemes → httpHeaderAuth (user must enter the header name and/or full value).
+- API key in the query string (?api_key=...) → httpQueryAuth.
+- username + password → httpBasicAuth.
+A user saying "API key" or "header auth" usually means httpBearerAuth only when the docs use the Authorization: Bearer <token> scheme. Use httpHeaderAuth for custom header names or non-Bearer Authorization schemes where the full header value/prefix must be user-controlled.
  * @displayOptions.show { authentication: ["genericCredentialType"] }
  */
     genericAuthType?: 'httpBasicAuth' | 'httpBearerAuth' | 'httpDigestAuth' | 'httpHeaderAuth' | 'httpQueryAuth' | 'httpCustomAuth' | 'oAuth1Api' | 'oAuth2Api' | Expression<string>;

package/dist/node-definitions/nodes/n8n-nodes-base/httpRequest/v4.ts

@@ -22,6 +22,12 @@ export interface HttpRequestV4Params {
     nodeCredentialType?: string;
 /**
  * Generic Auth Type
+ * @builderHint Pick by how the API authenticates, not by what the user calls it:
+- "Authorization: Bearer <token>" → httpBearerAuth (single token field, best UX). Use this for OpenAI, Anthropic, GitHub PATs, Stripe, Notion, and any service whose docs say "Bearer".
+- Custom header like X-API-Key, apikey, X-Auth-Token, or non-Bearer Authorization schemes → httpHeaderAuth (user must enter the header name and/or full value).
+- API key in the query string (?api_key=...) → httpQueryAuth.
+- username + password → httpBasicAuth.
+A user saying "API key" or "header auth" usually means httpBearerAuth only when the docs use the Authorization: Bearer <token> scheme. Use httpHeaderAuth for custom header names or non-Bearer Authorization schemes where the full header value/prefix must be user-controlled.
  * @displayOptions.show { authentication: ["genericCredentialType"] }
  */
     genericAuthType?: 'httpBasicAuth' | 'httpBearerAuth' | 'httpDigestAuth' | 'httpHeaderAuth' | 'httpQueryAuth' | 'httpCustomAuth' | 'oAuth1Api' | 'oAuth2Api' | Expression<string>;

package/dist/node-definitions/nodes/n8n-nodes-base/httpRequest/v41.ts

@@ -22,6 +22,12 @@ export interface HttpRequestV41Params {
     nodeCredentialType?: string;
 /**
  * Generic Auth Type
+ * @builderHint Pick by how the API authenticates, not by what the user calls it:
+- "Authorization: Bearer <token>" → httpBearerAuth (single token field, best UX). Use this for OpenAI, Anthropic, GitHub PATs, Stripe, Notion, and any service whose docs say "Bearer".
+- Custom header like X-API-Key, apikey, X-Auth-Token, or non-Bearer Authorization schemes → httpHeaderAuth (user must enter the header name and/or full value).
+- API key in the query string (?api_key=...) → httpQueryAuth.
+- username + password → httpBasicAuth.
+A user saying "API key" or "header auth" usually means httpBearerAuth only when the docs use the Authorization: Bearer <token> scheme. Use httpHeaderAuth for custom header names or non-Bearer Authorization schemes where the full header value/prefix must be user-controlled.
  * @displayOptions.show { authentication: ["genericCredentialType"] }
  */
     genericAuthType?: 'httpBasicAuth' | 'httpBearerAuth' | 'httpDigestAuth' | 'httpHeaderAuth' | 'httpQueryAuth' | 'httpCustomAuth' | 'oAuth1Api' | 'oAuth2Api' | Expression<string>;

package/dist/node-definitions/nodes/n8n-nodes-base/httpRequest/v42.ts

@@ -22,6 +22,12 @@ export interface HttpRequestV42Params {
     nodeCredentialType?: string;
 /**
  * Generic Auth Type
+ * @builderHint Pick by how the API authenticates, not by what the user calls it:
+- "Authorization: Bearer <token>" → httpBearerAuth (single token field, best UX). Use this for OpenAI, Anthropic, GitHub PATs, Stripe, Notion, and any service whose docs say "Bearer".
+- Custom header like X-API-Key, apikey, X-Auth-Token, or non-Bearer Authorization schemes → httpHeaderAuth (user must enter the header name and/or full value).
+- API key in the query string (?api_key=...) → httpQueryAuth.
+- username + password → httpBasicAuth.
+A user saying "API key" or "header auth" usually means httpBearerAuth only when the docs use the Authorization: Bearer <token> scheme. Use httpHeaderAuth for custom header names or non-Bearer Authorization schemes where the full header value/prefix must be user-controlled.
  * @displayOptions.show { authentication: ["genericCredentialType"] }
  */
     genericAuthType?: 'httpBasicAuth' | 'httpBearerAuth' | 'httpDigestAuth' | 'httpHeaderAuth' | 'httpQueryAuth' | 'httpCustomAuth' | 'oAuth1Api' | 'oAuth2Api' | Expression<string>;

package/dist/node-definitions/nodes/n8n-nodes-base/httpRequest/v43.ts

@@ -22,6 +22,12 @@ export interface HttpRequestV43Params {
     nodeCredentialType?: string;
 /**
  * Generic Auth Type
+ * @builderHint Pick by how the API authenticates, not by what the user calls it:
+- "Authorization: Bearer <token>" → httpBearerAuth (single token field, best UX). Use this for OpenAI, Anthropic, GitHub PATs, Stripe, Notion, and any service whose docs say "Bearer".
+- Custom header like X-API-Key, apikey, X-Auth-Token, or non-Bearer Authorization schemes → httpHeaderAuth (user must enter the header name and/or full value).
+- API key in the query string (?api_key=...) → httpQueryAuth.
+- username + password → httpBasicAuth.
+A user saying "API key" or "header auth" usually means httpBearerAuth only when the docs use the Authorization: Bearer <token> scheme. Use httpHeaderAuth for custom header names or non-Bearer Authorization schemes where the full header value/prefix must be user-controlled.
  * @displayOptions.show { authentication: ["genericCredentialType"] }
  */
     genericAuthType?: 'httpBasicAuth' | 'httpBearerAuth' | 'httpDigestAuth' | 'httpHeaderAuth' | 'httpQueryAuth' | 'httpCustomAuth' | 'oAuth1Api' | 'oAuth2Api' | Expression<string>;

package/dist/node-definitions/nodes/n8n-nodes-base/httpRequest/v44.ts

@@ -22,6 +22,12 @@ export interface HttpRequestV44Params {
     nodeCredentialType?: string;
 /**
  * Generic Auth Type
+ * @builderHint Pick by how the API authenticates, not by what the user calls it:
+- "Authorization: Bearer <token>" → httpBearerAuth (single token field, best UX). Use this for OpenAI, Anthropic, GitHub PATs, Stripe, Notion, and any service whose docs say "Bearer".
+- Custom header like X-API-Key, apikey, X-Auth-Token, or non-Bearer Authorization schemes → httpHeaderAuth (user must enter the header name and/or full value).
+- API key in the query string (?api_key=...) → httpQueryAuth.
+- username + password → httpBasicAuth.
+A user saying "API key" or "header auth" usually means httpBearerAuth only when the docs use the Authorization: Bearer <token> scheme. Use httpHeaderAuth for custom header names or non-Bearer Authorization schemes where the full header value/prefix must be user-controlled.
  * @displayOptions.show { authentication: ["genericCredentialType"] }
  */
     genericAuthType?: 'httpBasicAuth' | 'httpBearerAuth' | 'httpDigestAuth' | 'httpHeaderAuth' | 'httpQueryAuth' | 'httpCustomAuth' | 'oAuth1Api' | 'oAuth2Api' | Expression<string>;

package/dist/node-definitions/nodes/n8n-nodes-base/microsoftOneDriveTrigger/v1.ts

@@ -22,7 +22,7 @@ export interface MicrosoftOneDriveTriggerV1Params {
        * @default 14
        */
       hour?: number | Expression<number>;
-      /** The minute of the day to trigger
+      /** The minute past the hour to trigger (0-59)
        * @displayOptions.hide { mode: ["custom", "everyMinute", "everyX"] }
        * @default 0
        */

package/dist/node-definitions/nodes/n8n-nodes-base/microsoftOutlook/v2/resource_event/operation_create.ts

@@ -24,12 +24,12 @@ export type MicrosoftOutlookV2EventCreateParams = {
     subject: string | Expression<string>;
 /**
  * Start
- * @default 2026-05-14T10:25:06.605+00:00
+ * @default 2026-05-19T11:42:11.212+00:00
  */
     startDateTime?: string | Expression<string>;
 /**
  * End
- * @default 2026-05-14T10:55:06.605+00:00
+ * @default 2026-05-19T12:12:11.212+00:00
  */
     endDateTime?: string | Expression<string>;
 /**

package/dist/node-definitions/nodes/n8n-nodes-base/microsoftOutlookTrigger/v1.ts

@@ -22,7 +22,7 @@ export interface MicrosoftOutlookTriggerV1Params {
        * @default 14
        */
       hour?: number | Expression<number>;
-      /** The minute of the day to trigger
+      /** The minute past the hour to trigger (0-59)
        * @displayOptions.hide { mode: ["custom", "everyMinute", "everyX"] }
        * @default 0
        */

package/dist/node-definitions/nodes/n8n-nodes-base/nocoDb/index.ts

@@ -4,13 +4,15 @@
  * Re-exports all version-specific types and provides combined union type.
  */
 
+import type { NocoDbV4Node } from './v4';
 import type { NocoDbV3Node } from './v3';
 import type { NocoDbV2Node } from './v2';
 import type { NocoDbV1Node } from './v1';
 
+export * from './v4';
 export * from './v3';
 export * from './v2';
 export * from './v1';
 
 // Combined union type for all versions
-export type NocoDbNode = NocoDbV3Node | NocoDbV2Node | NocoDbV1Node;
+export type NocoDbNode = NocoDbV4Node | NocoDbV3Node | NocoDbV2Node | NocoDbV1Node;

package/dist/node-definitions/nodes/n8n-nodes-base/nocoDb/v4/index.schema.js

@@ -0,0 +1,24 @@
+/**
+ * NocoDB Node - Version 4 - Zod Schema Factory
+ * Exports a factory that unions all discriminator schemas.
+ *
+ * Schema helpers (z, expressionSchema, etc.) are passed as parameters
+ * by the schema-validator, not imported from external files.
+ *
+ * @generated - CommonJS JavaScript for runtime loading
+ */
+
+const getRowSchema = require('./resource_row/index.schema');
+const getLinkrowSchema = require('./resource_linkrow/index.schema');
+const getBaseSchema = require('./resource_base/index.schema');
+
+module.exports = function getSchema(helpers) {
+  const { parameters, z } = helpers;
+  // Apply discriminator default if not set
+  const effectiveParams = parameters.resource === undefined ? { ...parameters, resource: 'row' } : parameters;
+  return z.union([
+    getRowSchema({ ...helpers, parameters: effectiveParams }),
+    getLinkrowSchema({ ...helpers, parameters: effectiveParams }),
+    getBaseSchema({ ...helpers, parameters: effectiveParams }),
+  ]);
+};

package/dist/node-definitions/nodes/n8n-nodes-base/nocoDb/v4/index.ts

@@ -0,0 +1,18 @@
+/**
+ * NocoDB Node - Version 4
+ * Re-exports all discriminator combinations.
+ */
+
+import type { NocoDbV4RowNode } from './resource_row';
+import type { NocoDbV4LinkrowNode } from './resource_linkrow';
+import type { NocoDbV4BaseNode } from './resource_base';
+
+export * from './resource_row';
+export * from './resource_linkrow';
+export * from './resource_base';
+
+export type NocoDbV4Node =
+  | NocoDbV4RowNode
+  | NocoDbV4LinkrowNode
+  | NocoDbV4BaseNode
+  ;

package/dist/node-definitions/nodes/n8n-nodes-base/nocoDb/v4/resource_base/index.schema.js

@@ -0,0 +1,22 @@
+/**
+ * NocoDB - Base Resource - Zod Schema Factory
+ * Exports a factory that unions all operation schemas for this resource.
+ *
+ * Schema helpers (z, expressionSchema, etc.) are passed as parameters
+ * by the schema-validator, not imported from external files.
+ *
+ * @generated - CommonJS JavaScript for runtime loading
+ */
+
+const getGetSchema = require('./operation_get.schema');
+const getGetAllSchema = require('./operation_get_all.schema');
+
+module.exports = function getSchema(helpers) {
+  const { parameters, z } = helpers;
+  // Apply operation default if not set
+  const effectiveParams = parameters.operation === undefined ? { ...parameters, operation: 'get' } : parameters;
+  return z.union([
+    getGetSchema({ ...helpers, parameters: effectiveParams }),
+    getGetAllSchema({ ...helpers, parameters: effectiveParams }),
+  ]);
+};

package/dist/node-definitions/nodes/n8n-nodes-base/nocoDb/v4/resource_base/index.ts

@@ -0,0 +1,15 @@
+/**
+ * NocoDB - Base Resource
+ * Re-exports all operation types for this resource.
+ */
+
+import type { NocoDbV4BaseGetNode } from './operation_get';
+import type { NocoDbV4BaseGetAllNode } from './operation_get_all';
+
+export * from './operation_get';
+export * from './operation_get_all';
+
+export type NocoDbV4BaseNode =
+  | NocoDbV4BaseGetNode
+  | NocoDbV4BaseGetAllNode
+  ;

package/dist/node-definitions/nodes/n8n-nodes-base/nocoDb/v4/resource_base/operation_get.schema.js

@@ -0,0 +1,24 @@
+/**
+ * NocoDB Node - Version 4 - Zod Schema
+ * Discriminator: resource=base, operation=get
+ *
+ * Use .parse() for strict validation or .safeParse() for error handling.
+ *
+ * Schema helpers (z, expressionSchema, etc.) are passed as parameters
+ * by the schema-validator, not imported from external files.
+ *
+ * @generated - CommonJS JavaScript for runtime loading
+ */
+
+module.exports = function getSchema({ parameters, z, expressionSchema, stringOrExpression, numberOrExpression, booleanOrExpression, resourceLocatorValueSchema, resourceMapperValueSchema, filterValueSchema, assignmentCollectionValueSchema, iDataObjectSchema }) {
+
+  return z.object({
+    parameters: z.object({
+      resource: z.literal('base'),
+      operation: z.literal('get').default('get'),
+      authentication: z.union([z.literal('nocoDbApiToken'), z.literal('nocoDb'), expressionSchema]).optional(),
+      workspaceId: z.union([z.object({ __rl: z.literal(true), mode: z.union([z.literal('list'), z.literal('id')]), value: z.union([z.string(), z.number()]), cachedResultName: z.string().optional(), cachedResultUrl: z.string().optional() }), expressionSchema]).optional(),
+      projectId: z.union([z.object({ __rl: z.literal(true), mode: z.union([z.literal('list'), z.literal('id')]), value: z.union([z.string(), z.number()]), cachedResultName: z.string().optional(), cachedResultUrl: z.string().optional() }), expressionSchema]).optional(),
+    }).optional(),
+  });
+};

package/dist/node-definitions/nodes/n8n-nodes-base/nocoDb/v4/resource_base/operation_get.ts

@@ -0,0 +1,36 @@
+/**
+ * NocoDB Node - Version 4
+ * Discriminator: resource=base, operation=get
+ */
+
+
+interface Credentials {
+  nocoDb: CredentialReference;
+  nocoDbApiToken: CredentialReference;
+}
+
+/** Retrieve a record from a table */
+export type NocoDbV4BaseGetParams = {
+  resource: 'base';
+  operation: 'get';
+  authentication?: 'nocoDbApiToken' | 'nocoDb' | Expression<string>;
+/**
+ * Choose from the list, or specify an ID using an &lt;a href="https://docs.n8n.io/code/expressions/"&gt;expression&lt;/a&gt;
+ * @searchListMethod getWorkspaces
+ * @default {"mode":"list","value":""}
+ */
+    workspaceId?: { __rl: true; mode: 'list' | 'id'; value: string; cachedResultName?: string };
+/**
+ * Choose from the list, or specify an ID using an &lt;a href="https://docs.n8n.io/code/expressions/"&gt;expression&lt;/a&gt;
+ * @searchListMethod getBases
+ * @default {"mode":"list","value":""}
+ */
+    projectId?: { __rl: true; mode: 'list' | 'id'; value: string; cachedResultName?: string };
+};
+
+export type NocoDbV4BaseGetNode = {
+  type: 'n8n-nodes-base.nocoDb';
+  version: 4;
+  credentials?: Credentials;
+  config: NodeConfig<NocoDbV4BaseGetParams>;
+};

package/dist/node-definitions/nodes/n8n-nodes-base/nocoDb/v4/resource_base/operation_get_all.schema.js

@@ -0,0 +1,23 @@
+/**
+ * NocoDB Node - Version 4 - Zod Schema
+ * Discriminator: resource=base, operation=getAll
+ *
+ * Use .parse() for strict validation or .safeParse() for error handling.
+ *
+ * Schema helpers (z, expressionSchema, etc.) are passed as parameters
+ * by the schema-validator, not imported from external files.
+ *
+ * @generated - CommonJS JavaScript for runtime loading
+ */
+
+module.exports = function getSchema({ parameters, z, expressionSchema, stringOrExpression, numberOrExpression, booleanOrExpression, resourceLocatorValueSchema, resourceMapperValueSchema, filterValueSchema, assignmentCollectionValueSchema, iDataObjectSchema }) {
+
+  return z.object({
+    parameters: z.object({
+      resource: z.literal('base'),
+      operation: z.literal('getAll'),
+      authentication: z.union([z.literal('nocoDbApiToken'), z.literal('nocoDb'), expressionSchema]).optional(),
+      workspaceId: z.union([z.object({ __rl: z.literal(true), mode: z.union([z.literal('list'), z.literal('id')]), value: z.union([z.string(), z.number()]), cachedResultName: z.string().optional(), cachedResultUrl: z.string().optional() }), expressionSchema]).optional(),
+    }).optional(),
+  });
+};