n8n-nodes-base 2.21.2 → 2.22.0

package/dist/node-definitions/nodes/n8n-nodes-base/googleCloudStorage/v11/resource_object/operation_get.ts

@@ -0,0 +1,141 @@
+/**
+ * Google Cloud Storage Node - Version 1.1
+ * Discriminator: resource=object, operation=get
+ */
+
+
+interface Credentials {
+  googleCloudStorageOAuth2Api: CredentialReference;
+}
+
+/** Get metadata for a specific Bucket */
+export type GoogleCloudStorageV11ObjectGetParams = {
+  resource: 'object';
+  operation: 'get';
+/**
+ * Bucket Name
+ */
+    bucketName: string | Expression<string>;
+/**
+ * Object Name
+ */
+    objectName: string | Expression<string>;
+/**
+ * Projection
+ * @default noAcl
+ */
+    projection?: 'full' | 'noAcl';
+/**
+ * Return Data
+ * @default json
+ */
+    alt?: 'json' | 'media' | Expression<string>;
+/**
+ * Put Output File in Field
+ * @hint The name of the output binary field to put the file in
+ * @displayOptions.show { alt: ["media"] }
+ * @default data
+ */
+    binaryPropertyName?: string | Expression<string>;
+/**
+ * Additional Parameters
+ * @default {}
+ */
+    getParameters?: {
+    /** Generation
+     * @default -1
+     */
+    generation?: number | Expression<number>;
+    /** Generation Match
+     * @default -1
+     */
+    ifGenerationMatch?: number | Expression<number>;
+    /** Generation Exclude
+     * @default -1
+     */
+    ifGenerationNotMatch?: number | Expression<number>;
+    /** Metageneration Match
+     * @default -1
+     */
+    ifMetagenerationMatch?: number | Expression<number>;
+    /** Metageneration Exclude
+     * @default -1
+     */
+    ifMetagenerationNotMatch?: number | Expression<number>;
+  };
+/**
+ * Encryption Headers
+ * @default {}
+ */
+    encryptionHeaders?: {
+    /** Encryption Algorithm
+     * @default AES256
+     */
+    'X-Goog-Encryption-Algorithm'?: 'AES256' | Expression<string>;
+    /** Encryption Key
+     */
+    'X-Goog-Encryption-Key'?: string | Expression<string>;
+    /** Encryption Key Hash
+     */
+    'X-Goog-Encryption-Key-Sha256'?: string | Expression<string>;
+  };
+  requestOptions?: {
+    /** Batching
+     * @default {"batch":{}}
+     */
+    batching?: {
+        /** Batching
+     */
+    batch?: {
+      /** Input will be split in batches to throttle requests. -1 for disabled. 0 will be treated as 1.
+       * @default 50
+       */
+      batchSize?: number | Expression<number>;
+      /** Time (in milliseconds) between each batch of requests. 0 for disabled.
+       * @default 1000
+       */
+      batchInterval?: number | Expression<number>;
+    };
+  };
+    /** Whether to accept the response even if SSL certificate validation is not possible
+     * @default false
+     */
+    allowUnauthorizedCerts?: boolean;
+    /** HTTP proxy to use. If authentication is required it can be defined as follow: http://username:password@myproxy:3128
+     */
+    proxy?: string | Expression<string>;
+    /** Time in ms to wait for the server to send response headers (and start the response body) before aborting the request
+     * @default 10000
+     */
+    timeout?: number | Expression<number>;
+  };
+};
+
+export type GoogleCloudStorageV11ObjectGetOutput = {
+  bucket?: string;
+  contentType?: string;
+  crc32c?: string;
+  etag?: string;
+  generation?: string;
+  id?: string;
+  kind?: string;
+  md5Hash?: string;
+  mediaLink?: string;
+  metageneration?: string;
+  name?: string;
+  selfLink?: string;
+  size?: string;
+  storageClass?: string;
+  timeCreated?: string;
+  timeFinalized?: string;
+  timeStorageClassUpdated?: string;
+  updated?: string;
+};
+
+export type GoogleCloudStorageV11ObjectGetNode = {
+  type: 'n8n-nodes-base.googleCloudStorage';
+  version: 1.1;
+  credentials?: Credentials;
+  config: NodeConfig<GoogleCloudStorageV11ObjectGetParams>;
+  output?: Items<GoogleCloudStorageV11ObjectGetOutput>;
+};

package/dist/node-definitions/nodes/n8n-nodes-base/googleCloudStorage/v11/resource_object/operation_get_all.schema.js

@@ -0,0 +1,27 @@
+/**
+ * Google Cloud Storage Node - Version 1.1 - Zod Schema
+ * Discriminator: resource=object, 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, resolveSchema }) {
+
+  return z.object({
+    parameters: z.object({
+      resource: z.literal('object'),
+      operation: z.literal('getAll').default('getAll'),
+      bucketName: stringOrExpression,
+      projection: z.union([z.literal('full'), z.literal('noAcl')]).optional(),
+      returnAll: booleanOrExpression.optional(),
+      maxResults: resolveSchema({ parameters, schema: numberOrExpression, required: false, displayOptions: {"show":{"returnAll":[false]}}, defaults: {"returnAll":false} }),
+      listFilters: z.object({ delimiter: stringOrExpression.optional(), endOffset: stringOrExpression.optional(), includeTrailingDelimiter: booleanOrExpression.optional(), prefix: stringOrExpression.optional(), startOffset: stringOrExpression.optional(), versions: booleanOrExpression.optional() }).optional(),
+      requestOptions: z.object({ batching: z.object({ batch: z.object({ batchSize: numberOrExpression.optional(), batchInterval: numberOrExpression.optional() }).optional() }).optional(), allowUnauthorizedCerts: z.boolean().optional(), proxy: stringOrExpression.optional(), timeout: numberOrExpression.optional() }).optional(),
+    }).optional(),
+  });
+};

package/dist/node-definitions/nodes/n8n-nodes-base/googleCloudStorage/v11/resource_object/operation_get_all.ts

@@ -0,0 +1,123 @@
+/**
+ * Google Cloud Storage Node - Version 1.1
+ * Discriminator: resource=object, operation=getAll
+ */
+
+
+interface Credentials {
+  googleCloudStorageOAuth2Api: CredentialReference;
+}
+
+/** Get list of Buckets */
+export type GoogleCloudStorageV11ObjectGetAllParams = {
+  resource: 'object';
+  operation: 'getAll';
+/**
+ * Bucket Name
+ */
+    bucketName: string | Expression<string>;
+/**
+ * Projection
+ * @default noAcl
+ */
+    projection?: 'full' | 'noAcl';
+/**
+ * Whether to return all results or only up to a given limit
+ * @default false
+ */
+    returnAll?: boolean | Expression<boolean>;
+/**
+ * Max number of results to return
+ * @displayOptions.show { returnAll: [false] }
+ * @default 100
+ */
+    maxResults?: number | Expression<number>;
+/**
+ * Additional Parameters
+ * @default {}
+ */
+    listFilters?: {
+    /** Delimiter
+     * @default /
+     */
+    delimiter?: string | Expression<string>;
+    /** End Offset
+     */
+    endOffset?: string | Expression<string>;
+    /** Include Trailing Delimiter
+     * @default false
+     */
+    includeTrailingDelimiter?: boolean | Expression<boolean>;
+    /** Prefix
+     */
+    prefix?: string | Expression<string>;
+    /** Start Offset
+     */
+    startOffset?: string | Expression<string>;
+    /** Versions
+     * @default false
+     */
+    versions?: boolean | Expression<boolean>;
+  };
+  requestOptions?: {
+    /** Batching
+     * @default {"batch":{}}
+     */
+    batching?: {
+        /** Batching
+     */
+    batch?: {
+      /** Input will be split in batches to throttle requests. -1 for disabled. 0 will be treated as 1.
+       * @default 50
+       */
+      batchSize?: number | Expression<number>;
+      /** Time (in milliseconds) between each batch of requests. 0 for disabled.
+       * @default 1000
+       */
+      batchInterval?: number | Expression<number>;
+    };
+  };
+    /** Whether to accept the response even if SSL certificate validation is not possible
+     * @default false
+     */
+    allowUnauthorizedCerts?: boolean;
+    /** HTTP proxy to use. If authentication is required it can be defined as follow: http://username:password@myproxy:3128
+     */
+    proxy?: string | Expression<string>;
+    /** Time in ms to wait for the server to send response headers (and start the response body) before aborting the request
+     * @default 10000
+     */
+    timeout?: number | Expression<number>;
+  };
+};
+
+export type GoogleCloudStorageV11ObjectGetAllOutput = {
+  bucket?: string;
+  contentType?: string;
+  crc32c?: string;
+  etag?: string;
+  eventBasedHold?: boolean;
+  generation?: string;
+  id?: string;
+  kind?: string;
+  md5Hash?: string;
+  mediaLink?: string;
+  metageneration?: string;
+  name?: string;
+  selfLink?: string;
+  size?: string;
+  storageClass?: string;
+  temporaryHold?: boolean;
+  timeCreated?: string;
+  timeFinalized?: string;
+  timeStorageClassUpdated?: string;
+  updated?: string;
+};
+
+export type GoogleCloudStorageV11ObjectGetAllNode = {
+  type: 'n8n-nodes-base.googleCloudStorage';
+  version: 1.1;
+  credentials?: Credentials;
+  config: NodeConfig<GoogleCloudStorageV11ObjectGetAllParams>;
+  output?: Items<GoogleCloudStorageV11ObjectGetAllOutput>;
+};

package/dist/node-definitions/nodes/n8n-nodes-base/googleCloudStorage/v11/resource_object/operation_update.schema.js

@@ -0,0 +1,28 @@
+/**
+ * Google Cloud Storage Node - Version 1.1 - Zod Schema
+ * Discriminator: resource=object, operation=update
+ *
+ * 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('object'),
+      operation: z.literal('update'),
+      bucketName: stringOrExpression,
+      objectName: stringOrExpression,
+      updateProjection: z.union([z.literal('full'), z.literal('noAcl')]).optional(),
+      updateData: z.object({ acl: z.union([iDataObjectSchema, z.string()]).optional(), cacheControl: stringOrExpression.optional(), contentDisposition: stringOrExpression.optional(), contentEncoding: stringOrExpression.optional(), contentLanguage: stringOrExpression.optional(), contentType: stringOrExpression.optional(), customTime: stringOrExpression.optional(), eventBasedHold: booleanOrExpression.optional(), metadata: z.union([iDataObjectSchema, z.string()]).optional(), temporaryHold: booleanOrExpression.optional() }).optional(),
+      metagenAndAclQuery: z.object({ generation: numberOrExpression.optional(), ifGenerationMatch: numberOrExpression.optional(), ifGenerationNotMatch: numberOrExpression.optional(), ifMetagenerationMatch: numberOrExpression.optional(), ifMetagenerationNotMatch: numberOrExpression.optional(), predefinedAcl: z.union([z.literal('authenticatedRead'), z.literal('bucketOwnerFullControl'), z.literal('bucketOwnerRead'), z.literal('private'), z.literal('projectPrivate'), z.literal('publicRead'), expressionSchema]).optional() }).optional(),
+      encryptionHeaders: z.object({ 'X-Goog-Encryption-Algorithm': z.union([z.literal('AES256'), expressionSchema]).optional(), 'X-Goog-Encryption-Key': stringOrExpression.optional(), 'X-Goog-Encryption-Key-Sha256': stringOrExpression.optional() }).optional(),
+      requestOptions: z.object({ batching: z.object({ batch: z.object({ batchSize: numberOrExpression.optional(), batchInterval: numberOrExpression.optional() }).optional() }).optional(), allowUnauthorizedCerts: z.boolean().optional(), proxy: stringOrExpression.optional(), timeout: numberOrExpression.optional() }).optional(),
+    }).optional(),
+  });
+};

package/dist/node-definitions/nodes/n8n-nodes-base/googleCloudStorage/v11/resource_object/operation_update.ts

@@ -0,0 +1,173 @@
+/**
+ * Google Cloud Storage Node - Version 1.1
+ * Discriminator: resource=object, operation=update
+ */
+
+
+interface Credentials {
+  googleCloudStorageOAuth2Api: CredentialReference;
+}
+
+/** Update the metadata of a bucket */
+export type GoogleCloudStorageV11ObjectUpdateParams = {
+  resource: 'object';
+  operation: 'update';
+/**
+ * Bucket Name
+ */
+    bucketName: string | Expression<string>;
+/**
+ * Object Name
+ */
+    objectName: string | Expression<string>;
+/**
+ * Projection
+ * @default full
+ */
+    updateProjection?: 'full' | 'noAcl';
+/**
+ * Update Fields
+ * @default {"acl":"[]"}
+ */
+    updateData?: {
+    /** Access Control
+     * @default []
+     */
+    acl?: IDataObject | string | Expression<string>;
+    /** Cache Control
+     */
+    cacheControl?: string | Expression<string>;
+    /** Content Disposition
+     */
+    contentDisposition?: string | Expression<string>;
+    /** Content Encoding
+     */
+    contentEncoding?: string | Expression<string>;
+    /** Content Language
+     */
+    contentLanguage?: string | Expression<string>;
+    /** Content Type
+     */
+    contentType?: string | Expression<string>;
+    /** Custom Time
+     */
+    customTime?: string | Expression<string>;
+    /** Event Based Hold
+     * @default false
+     */
+    eventBasedHold?: boolean | Expression<boolean>;
+    /** Metadata
+     * @default {}
+     */
+    metadata?: IDataObject | string | Expression<string>;
+    /** Temporary Hold
+     * @default false
+     */
+    temporaryHold?: boolean | Expression<boolean>;
+  };
+/**
+ * Additional Parameters
+ * @default {}
+ */
+    metagenAndAclQuery?: {
+    /** Generation
+     * @default -1
+     */
+    generation?: number | Expression<number>;
+    /** Generation Match
+     * @default -1
+     */
+    ifGenerationMatch?: number | Expression<number>;
+    /** Generation Exclude
+     * @default -1
+     */
+    ifGenerationNotMatch?: number | Expression<number>;
+    /** Metageneration Match
+     * @default -1
+     */
+    ifMetagenerationMatch?: number | Expression<number>;
+    /** Metageneration Exclude
+     * @default -1
+     */
+    ifMetagenerationNotMatch?: number | Expression<number>;
+    /** Predefined ACL
+     * @default authenticatedRead
+     */
+    predefinedAcl?: 'authenticatedRead' | 'bucketOwnerFullControl' | 'bucketOwnerRead' | 'private' | 'projectPrivate' | 'publicRead' | Expression<string>;
+  };
+/**
+ * Encryption Headers
+ * @default {}
+ */
+    encryptionHeaders?: {
+    /** Encryption Algorithm
+     * @default AES256
+     */
+    'X-Goog-Encryption-Algorithm'?: 'AES256' | Expression<string>;
+    /** Encryption Key
+     */
+    'X-Goog-Encryption-Key'?: string | Expression<string>;
+    /** Encryption Key Hash
+     */
+    'X-Goog-Encryption-Key-Sha256'?: string | Expression<string>;
+  };
+  requestOptions?: {
+    /** Batching
+     * @default {"batch":{}}
+     */
+    batching?: {
+        /** Batching
+     */
+    batch?: {
+      /** Input will be split in batches to throttle requests. -1 for disabled. 0 will be treated as 1.
+       * @default 50
+       */
+      batchSize?: number | Expression<number>;
+      /** Time (in milliseconds) between each batch of requests. 0 for disabled.
+       * @default 1000
+       */
+      batchInterval?: number | Expression<number>;
+    };
+  };
+    /** Whether to accept the response even if SSL certificate validation is not possible
+     * @default false
+     */
+    allowUnauthorizedCerts?: boolean;
+    /** HTTP proxy to use. If authentication is required it can be defined as follow: http://username:password@myproxy:3128
+     */
+    proxy?: string | Expression<string>;
+    /** Time in ms to wait for the server to send response headers (and start the response body) before aborting the request
+     * @default 10000
+     */
+    timeout?: number | Expression<number>;
+  };
+};
+
+export type GoogleCloudStorageV11ObjectUpdateOutput = {
+  bucket?: string;
+  contentType?: string;
+  crc32c?: string;
+  etag?: string;
+  generation?: string;
+  id?: string;
+  kind?: string;
+  md5Hash?: string;
+  mediaLink?: string;
+  metageneration?: string;
+  name?: string;
+  selfLink?: string;
+  size?: string;
+  storageClass?: string;
+  timeCreated?: string;
+  timeFinalized?: string;
+  timeStorageClassUpdated?: string;
+  updated?: string;
+};
+
+export type GoogleCloudStorageV11ObjectUpdateNode = {
+  type: 'n8n-nodes-base.googleCloudStorage';
+  version: 1.1;
+  credentials?: Credentials;
+  config: NodeConfig<GoogleCloudStorageV11ObjectUpdateParams>;
+  output?: Items<GoogleCloudStorageV11ObjectUpdateOutput>;
+};

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

@@ -22,7 +22,7 @@ export interface GoogleDriveTriggerV1Params {
        * @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/googleSheets/v1/resource_sheet/operation_append.ts

@@ -11,6 +11,30 @@ interface Credentials {
 
 /** Append data to a sheet */
 export type GoogleSheetsV1SheetAppendParams = {
+  /**
+   * <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';
 /**

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

@@ -11,6 +11,30 @@ interface Credentials {
 
 /** Update rows in a sheet */
 export type GoogleSheetsV1SheetUpdateParams = {
+  /**
+   * <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';
 /**

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

@@ -11,6 +11,30 @@ interface Credentials {
 
 /** Append data to a sheet */
 export type GoogleSheetsV2SheetAppendParams = {
+  /**
+   * <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';
 /**

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

@@ -11,6 +11,30 @@ interface Credentials {
 
 /** Update rows in a sheet */
 export type GoogleSheetsV2SheetUpdateParams = {
+  /**
+   * <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';
 /**

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

@@ -11,19 +11,43 @@ interface Credentials {
 
 /** Create a new row in a sheet */
 export type GoogleSheetsV3SheetAppendParams = {
+  /**
+   * <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":""}
  */