first commit
Security: Sync from Public / sync-from-public (push) Has been cancelled
Test: Benchmark Nightly / build (push) Has been cancelled
Test: Benchmark Nightly / Notify Cats on failure (push) Has been cancelled
CI: Python / Checks (push) Has been cancelled
Test: Evals Python / Workflow Comparison Python (push) Has been cancelled
Util: Check Docs URLs / check-docs-urls (push) Has been cancelled
Test: Visual Storybook / Cloudflare Pages (push) Has been cancelled
Test: E2E Performance / build-and-test-performance (push) Has been cancelled
Test: Workflows Nightly / Run Workflow Tests (push) Has been cancelled
Util: Cleanup CI Docker Images / Delete stale CI images (push) Has been cancelled
Test: Benchmark Destroy Env / build (push) Has been cancelled
Util: Update Node Popularity / update-popularity (push) Has been cancelled
Test: E2E Coverage Weekly / Coverage Tests (push) Has been cancelled

This commit is contained in:
2026-03-17 16:22:57 +03:30
commit 3d5eaf9445
15349 changed files with 2847338 additions and 0 deletions
@@ -0,0 +1,136 @@
import type { INodeProperties } from 'n8n-workflow';
import { HeaderConstants } from '../helpers/constants';
import { untilContainerSelected } from '../helpers/utils';
export const containerResourceLocator: INodeProperties = {
displayName: 'Container',
name: 'container',
default: {
mode: 'list',
value: '',
},
modes: [
{
displayName: 'From list',
name: 'list',
type: 'list',
typeOptions: {
searchListMethod: 'searchContainers',
searchable: true,
},
},
{
displayName: 'By ID',
name: 'id',
hint: 'Enter the container ID',
placeholder: 'e.g. AndersenFamily',
type: 'string',
validation: [
{
type: 'regex',
properties: {
regex: '^[\\w+=,.@-]+$',
errorMessage: 'The container ID must follow the allowed pattern',
},
},
],
},
],
required: true,
type: 'resourceLocator',
};
export const itemResourceLocator: INodeProperties = {
displayName: 'Item',
name: 'item',
default: {
mode: 'list',
value: '',
},
displayOptions: {
hide: {
...untilContainerSelected,
},
},
modes: [
{
displayName: 'From list',
name: 'list',
type: 'list',
typeOptions: {
searchListMethod: 'searchItems',
searchable: true,
},
},
{
displayName: 'By ID',
name: 'id',
hint: 'Enter the item ID',
placeholder: 'e.g. AndersenFamily',
type: 'string',
validation: [
{
type: 'regex',
properties: {
regex: '^[\\w+=,.@-]+$',
errorMessage: 'The item ID must follow the allowed pattern',
},
},
],
},
],
required: true,
type: 'resourceLocator',
};
export const paginationParameters: INodeProperties[] = [
{
displayName: 'Return All',
name: 'returnAll',
default: false,
description: 'Whether to return all results or only up to a given limit',
routing: {
send: {
paginate: '={{ $value }}',
},
operations: {
pagination: {
type: 'generic',
properties: {
continue: `={{ !!$response.headers?.["${HeaderConstants.X_MS_CONTINUATION}"] }}`,
request: {
headers: {
[HeaderConstants.X_MS_CONTINUATION]: `={{ $response.headers?.["${HeaderConstants.X_MS_CONTINUATION}"] }}`,
},
},
},
},
},
},
type: 'boolean',
},
{
displayName: 'Limit',
name: 'limit',
default: 50,
description: 'Max number of results to return',
displayOptions: {
show: {
returnAll: [false],
},
},
routing: {
request: {
headers: {
[HeaderConstants.X_MS_MAX_ITEM_COUNT]: '={{ $value || undefined }}',
},
},
},
type: 'number',
typeOptions: {
minValue: 1,
},
validateType: 'number',
},
];
@@ -0,0 +1,107 @@
import type { INodeProperties } from 'n8n-workflow';
import * as create from './create.operation';
import * as del from './delete.operation';
import * as get from './get.operation';
import * as getAll from './getAll.operation';
import { handleError } from '../../helpers/errorHandler';
import { simplifyData } from '../../helpers/utils';
export const description: INodeProperties[] = [
{
displayName: 'Operation',
name: 'operation',
type: 'options',
noDataExpression: true,
displayOptions: {
show: {
resource: ['container'],
},
},
options: [
{
name: 'Create',
value: 'create',
description: 'Create a container',
routing: {
request: {
method: 'POST',
url: '/colls',
},
output: {
postReceive: [handleError],
},
},
action: 'Create container',
},
{
name: 'Delete',
value: 'delete',
description: 'Delete a container',
routing: {
request: {
method: 'DELETE',
url: '=/colls/{{ $parameter["container"] }}',
},
output: {
postReceive: [
handleError,
{
type: 'set',
properties: {
value: '={{ { "deleted": true } }}',
},
},
],
},
},
action: 'Delete container',
},
{
name: 'Get',
value: 'get',
description: 'Retrieve a container',
routing: {
request: {
method: 'GET',
url: '=/colls/{{ $parameter["container"] }}',
},
output: {
postReceive: [handleError, simplifyData],
},
},
action: 'Get container',
},
{
name: 'Get Many',
value: 'getAll',
description: 'Retrieve a list of containers',
routing: {
request: {
method: 'GET',
url: '/colls',
},
output: {
postReceive: [
handleError,
{
type: 'rootProperty',
properties: {
property: 'DocumentCollections',
},
},
simplifyData,
],
},
},
action: 'Get many containers',
},
],
default: 'getAll',
},
...create.description,
...del.description,
...get.description,
...getAll.description,
];
@@ -0,0 +1,164 @@
import type {
IDataObject,
IExecuteSingleFunctions,
IHttpRequestOptions,
INodeProperties,
} from 'n8n-workflow';
import { OperationalError, updateDisplayOptions } from 'n8n-workflow';
import { HeaderConstants } from '../../helpers/constants';
import { processJsonInput } from '../../helpers/utils';
const properties: INodeProperties[] = [
{
displayName: 'ID',
name: 'containerCreate',
default: '',
description: 'Unique identifier for the new container',
placeholder: 'e.g. Container1',
required: true,
routing: {
send: {
preSend: [
async function (
this: IExecuteSingleFunctions,
requestOptions: IHttpRequestOptions,
): Promise<IHttpRequestOptions> {
const id = this.getNodeParameter('containerCreate') as string;
if (/\s/.test(id)) {
throw new OperationalError('The container ID must not contain spaces.');
}
if (!/^[a-zA-Z0-9-_]+$/.test(id)) {
throw new OperationalError(
'The container ID may only contain letters, numbers, hyphens, and underscores.',
);
}
(requestOptions.body as IDataObject).id = id;
return requestOptions;
},
],
},
},
type: 'string',
},
{
displayName: 'Partition Key',
name: 'partitionKey',
default: '{\n\t"paths": [\n\t\t"/id"\n\t],\n\t"kind": "Hash",\n\t"version": 2\n}',
description:
'The partition key is used to automatically distribute data across partitions for scalability. Choose a property in your JSON document that has a wide range of values and evenly distributes request volume.',
required: true,
routing: {
send: {
preSend: [
async function (
this: IExecuteSingleFunctions,
requestOptions: IHttpRequestOptions,
): Promise<IHttpRequestOptions> {
const rawPartitionKey = this.getNodeParameter('partitionKey') as IDataObject;
const partitionKey = processJsonInput(rawPartitionKey, 'Partition Key', {
paths: ['/id'],
kind: 'Hash',
version: 2,
});
(requestOptions.body as IDataObject).partitionKey = partitionKey;
return requestOptions;
},
],
},
},
type: 'json',
},
{
displayName: 'Additional Fields',
name: 'additionalFields',
default: {},
options: [
{
displayName: 'Indexing Policy',
name: 'indexingPolicy',
default:
'{\n\t"indexingMode": "consistent",\n\t"automatic": true,\n\t"includedPaths": [\n\t\t{\n\t\t\t"path": "/*"\n\t\t}\n\t],\n\t"excludedPaths": []\n}',
description: 'This value is used to configure indexing policy',
routing: {
send: {
preSend: [
async function (
this: IExecuteSingleFunctions,
requestOptions: IHttpRequestOptions,
): Promise<IHttpRequestOptions> {
const rawIndexingPolicy = this.getNodeParameter(
'additionalFields.indexingPolicy',
) as IDataObject;
const indexPolicy = processJsonInput(rawIndexingPolicy, 'Indexing Policy');
(requestOptions.body as IDataObject).indexingPolicy = indexPolicy;
return requestOptions;
},
],
},
},
type: 'json',
},
{
displayName: 'Max RU/s (for Autoscale)',
name: 'maxThroughput',
default: 1000,
description: 'The user specified autoscale max RU/s',
displayOptions: {
hide: {
'/additionalFields.offerThroughput': [{ _cnd: { exists: true } }],
},
},
routing: {
request: {
headers: {
[HeaderConstants.X_MS_COSMOS_OFFER_AUTOPILOT_SETTING]: '={{ $value }}',
},
},
},
type: 'number',
typeOptions: {
minValue: 1000,
},
},
{
displayName: 'Manual Throughput RU/s',
name: 'offerThroughput',
default: 400,
description:
'The user specified manual throughput (RU/s) for the collection expressed in units of 100 request units per second',
displayOptions: {
hide: {
'/additionalFields.maxThroughput': [{ _cnd: { exists: true } }],
},
},
routing: {
request: {
headers: {
[HeaderConstants.X_MS_OFFER_THROUGHPUT]: '={{ $value }}',
},
},
},
type: 'number',
typeOptions: {
minValue: 400,
},
},
],
placeholder: 'Add Option',
type: 'collection',
},
];
const displayOptions = {
show: {
resource: ['container'],
operation: ['create'],
},
};
export const description = updateDisplayOptions(displayOptions, properties);
@@ -0,0 +1,16 @@
import { updateDisplayOptions, type INodeProperties } from 'n8n-workflow';
import { containerResourceLocator } from '../common';
const properties: INodeProperties[] = [
{ ...containerResourceLocator, description: 'Select the container you want to delete' },
];
const displayOptions = {
show: {
resource: ['container'],
operation: ['delete'],
},
};
export const description = updateDisplayOptions(displayOptions, properties);
@@ -0,0 +1,23 @@
import { updateDisplayOptions, type INodeProperties } from 'n8n-workflow';
import { containerResourceLocator } from '../common';
const properties: INodeProperties[] = [
{ ...containerResourceLocator, description: 'Select the container you want to retrieve' },
{
displayName: 'Simplify',
name: 'simple',
default: true,
description: 'Whether to return a simplified version of the response instead of the raw data',
type: 'boolean',
},
];
const displayOptions = {
show: {
resource: ['container'],
operation: ['get'],
},
};
export const description = updateDisplayOptions(displayOptions, properties);
@@ -0,0 +1,23 @@
import { updateDisplayOptions, type INodeProperties } from 'n8n-workflow';
import { paginationParameters } from '../common';
const properties: INodeProperties[] = [
...paginationParameters,
{
displayName: 'Simplify',
name: 'simple',
default: true,
description: 'Whether to return a simplified version of the response instead of the raw data',
type: 'boolean',
},
];
const displayOptions = {
show: {
resource: ['container'],
operation: ['getAll'],
},
};
export const description = updateDisplayOptions(displayOptions, properties);
@@ -0,0 +1,2 @@
export * as container from './container/Container.resource';
export * as item from './item/Item.resource';
@@ -0,0 +1,176 @@
import type { INodeProperties } from 'n8n-workflow';
import * as create from './create.operation';
import * as del from './delete.operation';
import * as get from './get.operation';
import * as getAll from './getAll.operation';
import * as query from './query.operation';
import * as update from './update.operation';
import { HeaderConstants } from '../../helpers/constants';
import { handleError } from '../../helpers/errorHandler';
import { simplifyData, validatePartitionKey } from '../../helpers/utils';
export const description: INodeProperties[] = [
{
displayName: 'Operation',
name: 'operation',
type: 'options',
noDataExpression: true,
displayOptions: {
show: {
resource: ['item'],
},
},
options: [
{
name: 'Create',
value: 'create',
description: 'Create a new item',
routing: {
send: {
preSend: [validatePartitionKey],
},
request: {
method: 'POST',
url: '=/colls/{{ $parameter["container"] }}/docs',
headers: {
[HeaderConstants.X_MS_DOCUMENTDB_IS_UPSERT]: 'True',
},
},
output: {
postReceive: [handleError],
},
},
action: 'Create item',
},
{
name: 'Delete',
value: 'delete',
description: 'Delete an existing item',
routing: {
send: {
preSend: [validatePartitionKey],
},
request: {
method: 'DELETE',
url: '=/colls/{{ $parameter["container"] }}/docs/{{ $parameter["item"] }}',
},
output: {
postReceive: [
handleError,
{
type: 'set',
properties: {
value: '={{ { "deleted": true } }}',
},
},
],
},
},
action: 'Delete item',
},
{
name: 'Get',
value: 'get',
description: 'Retrieve an item',
routing: {
send: {
preSend: [validatePartitionKey],
},
request: {
method: 'GET',
url: '=/colls/{{ $parameter["container"]}}/docs/{{$parameter["item"]}}',
headers: {
[HeaderConstants.X_MS_DOCUMENTDB_IS_UPSERT]: 'True',
},
},
output: {
postReceive: [handleError, simplifyData],
},
},
action: 'Get item',
},
{
name: 'Get Many',
value: 'getAll',
description: 'Retrieve a list of items',
routing: {
request: {
method: 'GET',
url: '=/colls/{{ $parameter["container"] }}/docs',
},
output: {
postReceive: [
handleError,
{
type: 'rootProperty',
properties: {
property: 'Documents',
},
},
simplifyData,
],
},
},
action: 'Get many items',
},
{
name: 'Execute Query',
value: 'query',
routing: {
request: {
method: 'POST',
url: '=/colls/{{ $parameter["container"] }}/docs',
headers: {
'Content-Type': 'application/query+json',
'x-ms-documentdb-isquery': 'True',
'x-ms-documentdb-query-enablecrosspartition': 'True',
},
},
output: {
postReceive: [
handleError,
{
type: 'rootProperty',
properties: {
property: 'Documents',
},
},
simplifyData,
],
},
},
action: 'Query items',
},
{
name: 'Update',
value: 'update',
description: 'Update an existing item',
routing: {
send: {
preSend: [validatePartitionKey],
},
request: {
method: 'PUT',
url: '=/colls/{{ $parameter["container"] }}/docs/{{ $parameter["item"] }}',
headers: {
'Content-Type': 'application/json-patch+json',
},
},
output: {
postReceive: [handleError],
},
},
action: 'Update item',
},
],
default: 'getAll',
},
...create.description,
...del.description,
...get.description,
...getAll.description,
...query.description,
...update.description,
];
@@ -0,0 +1,57 @@
import type {
IDataObject,
IExecuteSingleFunctions,
IHttpRequestOptions,
INodeProperties,
} from 'n8n-workflow';
import { updateDisplayOptions } from 'n8n-workflow';
import { processJsonInput, untilContainerSelected } from '../../helpers/utils';
import { containerResourceLocator } from '../common';
const properties: INodeProperties[] = [
{ ...containerResourceLocator, description: 'Select the container you want to use' },
{
displayName: 'Item Contents',
name: 'customProperties',
default: '{\n\t"id": "replace_with_new_document_id"\n}',
description: 'The item contents as a JSON object',
displayOptions: {
hide: {
...untilContainerSelected,
},
},
hint: 'The item requires an ID and partition key value if a custom key is set',
required: true,
routing: {
send: {
preSend: [
async function (
this: IExecuteSingleFunctions,
requestOptions: IHttpRequestOptions,
): Promise<IHttpRequestOptions> {
const rawCustomProperties = this.getNodeParameter('customProperties') as IDataObject;
const customProperties = processJsonInput(
rawCustomProperties,
'Item Contents',
undefined,
['id'],
);
requestOptions.body = customProperties;
return requestOptions;
},
],
},
},
type: 'json',
},
];
const displayOptions = {
show: {
resource: ['item'],
operation: ['create'],
},
};
export const description = updateDisplayOptions(displayOptions, properties);
@@ -0,0 +1,40 @@
import { updateDisplayOptions, type INodeProperties } from 'n8n-workflow';
import { untilContainerSelected, untilItemSelected } from '../../helpers/utils';
import { containerResourceLocator, itemResourceLocator } from '../common';
const properties: INodeProperties[] = [
{ ...containerResourceLocator, description: 'Select the container you want to use' },
{ ...itemResourceLocator, description: 'Select the item to be deleted' },
{
displayName: 'Additional Fields',
name: 'additionalFields',
default: {},
displayOptions: {
hide: {
...untilContainerSelected,
...untilItemSelected,
},
},
options: [
{
displayName: 'Partition Key',
name: 'partitionKey',
default: '',
hint: 'Only required if a custom partition key is set for the container',
type: 'string',
},
],
placeholder: 'Add Partition Key',
type: 'collection',
},
];
const displayOptions = {
show: {
resource: ['item'],
operation: ['delete'],
},
};
export const description = updateDisplayOptions(displayOptions, properties);
@@ -0,0 +1,53 @@
import { updateDisplayOptions, type INodeProperties } from 'n8n-workflow';
import { untilContainerSelected, untilItemSelected } from '../../helpers/utils';
import { containerResourceLocator, itemResourceLocator } from '../common';
const properties: INodeProperties[] = [
{ ...containerResourceLocator, description: 'Select the container you want to use' },
{ ...itemResourceLocator, description: 'Select the item you want to retrieve' },
{
displayName: 'Simplify',
name: 'simple',
default: true,
description: 'Whether to return a simplified version of the response instead of the raw data',
displayOptions: {
hide: {
...untilContainerSelected,
...untilItemSelected,
},
},
type: 'boolean',
},
{
displayName: 'Additional Fields',
name: 'additionalFields',
default: {},
displayOptions: {
hide: {
...untilContainerSelected,
...untilItemSelected,
},
},
options: [
{
displayName: 'Partition Key',
name: 'partitionKey',
default: '',
hint: 'Only required if a custom partition key is set for the container',
type: 'string',
},
],
placeholder: 'Add Partition Key',
type: 'collection',
},
];
const displayOptions = {
show: {
resource: ['item'],
operation: ['get'],
},
};
export const description = updateDisplayOptions(displayOptions, properties);
@@ -0,0 +1,24 @@
import { updateDisplayOptions, type INodeProperties } from 'n8n-workflow';
import { containerResourceLocator, paginationParameters } from '../common';
const properties: INodeProperties[] = [
{ ...containerResourceLocator, description: 'Select the container you want to use' },
...paginationParameters,
{
displayName: 'Simplify',
name: 'simple',
default: true,
description: 'Whether to return a simplified version of the response instead of the raw data',
type: 'boolean',
},
];
const displayOptions = {
show: {
resource: ['item'],
operation: ['getAll'],
},
};
export const description = updateDisplayOptions(displayOptions, properties);
@@ -0,0 +1,80 @@
import { updateDisplayOptions, type INodeProperties } from 'n8n-workflow';
import { validateQueryParameters } from '../../helpers/utils';
import { containerResourceLocator } from '../common';
const properties: INodeProperties[] = [
{ ...containerResourceLocator, description: 'Select the container you want to use' },
{
displayName: 'Query',
name: 'query',
default: '',
description:
"The SQL query to execute. Use $1, $2, $3, etc., to reference the 'Query Parameters' set in the options below.",
hint: 'Consider using query parameters to prevent SQL injection attacks. Add them in the options below.',
noDataExpression: true,
placeholder: 'e.g. SELECT id, name FROM c WHERE c.name = $1',
required: true,
routing: {
send: {
type: 'body',
property: 'query',
value: "={{ $value.replace(/\\$(\\d+)/g, '@Param$1') }}",
},
},
type: 'string',
typeOptions: {
editor: 'sqlEditor',
sqlDialect: 'StandardSQL',
},
},
{
displayName: 'Simplify',
name: 'simple',
default: true,
description: 'Whether to return a simplified version of the response instead of the raw data',
type: 'boolean',
},
{
displayName: 'Options',
name: 'options',
default: {},
options: [
{
displayName: 'Query Options',
name: 'queryOptions',
values: [
{
displayName: 'Query Parameters',
name: 'queryParameters',
default: '',
description:
'Comma-separated list of values used as query parameters. Use $1, $2, $3, etc., in your query.',
hint: 'Reference them in your query as $1, $2, $3…',
placeholder: 'e.g. value1,value2,value3',
routing: {
send: {
preSend: [validateQueryParameters],
},
},
type: 'string',
},
],
},
],
placeholder: 'Add options',
type: 'fixedCollection',
typeOptions: {
multipleValues: false,
},
},
];
const displayOptions = {
show: {
resource: ['item'],
operation: ['query'],
},
};
export const description = updateDisplayOptions(displayOptions, properties);
@@ -0,0 +1,64 @@
import type { INodeProperties } from 'n8n-workflow';
import { updateDisplayOptions } from 'n8n-workflow';
import {
untilContainerSelected,
untilItemSelected,
validateCustomProperties,
} from '../../helpers/utils';
import { containerResourceLocator, itemResourceLocator } from '../common';
const properties: INodeProperties[] = [
{ ...containerResourceLocator, description: 'Select the container you want to use' },
{ ...itemResourceLocator, description: 'Select the item to be updated' },
{
displayName: 'Item Contents',
name: 'customProperties',
default: '{}',
description: 'The item contents as a JSON object',
displayOptions: {
hide: {
...untilContainerSelected,
...untilItemSelected,
},
},
required: true,
routing: {
send: {
preSend: [validateCustomProperties],
},
},
type: 'json',
},
{
displayName: 'Additional Fields',
name: 'additionalFields',
default: {},
displayOptions: {
hide: {
...untilContainerSelected,
...untilItemSelected,
},
},
options: [
{
displayName: 'Partition Key',
name: 'partitionKey',
type: 'string',
hint: 'Only required if a custom partition key is set for the container',
default: '',
},
],
placeholder: 'Add Partition Key',
type: 'collection',
},
];
const displayOptions = {
show: {
resource: ['item'],
operation: ['update'],
},
};
export const description = updateDisplayOptions(displayOptions, properties);