Align MCP and n8n document listing endpoints with the GraphQL console API so every document filter is available across all three interfaces. MCP: - listDocuments: add status filter, default to ACTIVE - listDocumentVersions: add statuses filter - DocumentOrderField: add UPDATED_AT n8n: - document getAll: add query, documentTypes, classifications, status filters (default ACTIVE) - document getAllVersions: add statuses filter - document getAllSignatures: add states and activeContract filters Signed-off-by: Sacha Al Himdani <sacha@getprobo.com>
158 lines
4.0 KiB
TypeScript
158 lines
4.0 KiB
TypeScript
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
|
|
//
|
|
// Permission to use, copy, modify, and/or distribute this software for any
|
|
// purpose with or without fee is hereby granted, provided that the above
|
|
// copyright notice and this permission notice appear in all copies.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
|
|
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
|
|
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
|
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
|
|
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
// PERFORMANCE OF THIS SOFTWARE.
|
|
|
|
import type { INodeProperties, IExecuteFunctions, INodeExecutionData, IDataObject } from 'n8n-workflow';
|
|
import { proboApiRequestAllItems } from '../../GenericFunctions';
|
|
|
|
export const description: INodeProperties[] = [
|
|
{
|
|
displayName: 'Document ID',
|
|
name: 'documentId',
|
|
type: 'string',
|
|
displayOptions: {
|
|
show: {
|
|
resource: ['document'],
|
|
operation: ['getAllVersions'],
|
|
},
|
|
},
|
|
default: '',
|
|
description: 'The ID of the document',
|
|
required: true,
|
|
},
|
|
{
|
|
displayName: 'Return All',
|
|
name: 'returnAll',
|
|
type: 'boolean',
|
|
displayOptions: {
|
|
show: {
|
|
resource: ['document'],
|
|
operation: ['getAllVersions'],
|
|
},
|
|
},
|
|
default: false,
|
|
description: 'Whether to return all results or only up to a given limit',
|
|
},
|
|
{
|
|
displayName: 'Limit',
|
|
name: 'limit',
|
|
type: 'number',
|
|
displayOptions: {
|
|
show: {
|
|
resource: ['document'],
|
|
operation: ['getAllVersions'],
|
|
returnAll: [false],
|
|
},
|
|
},
|
|
typeOptions: {
|
|
minValue: 1,
|
|
},
|
|
default: 50,
|
|
description: 'Max number of results to return',
|
|
},
|
|
{
|
|
displayName: 'Filters',
|
|
name: 'filters',
|
|
type: 'collection',
|
|
placeholder: 'Add Filter',
|
|
default: {},
|
|
displayOptions: {
|
|
show: {
|
|
resource: ['document'],
|
|
operation: ['getAllVersions'],
|
|
},
|
|
},
|
|
options: [
|
|
{
|
|
displayName: 'Statuses',
|
|
name: 'statuses',
|
|
type: 'multiOptions',
|
|
default: [],
|
|
description: 'Filter by version status',
|
|
options: [
|
|
{ name: 'Draft', value: 'DRAFT' },
|
|
{ name: 'Pending Approval', value: 'PENDING_APPROVAL' },
|
|
{ name: 'Published', value: 'PUBLISHED' },
|
|
],
|
|
},
|
|
],
|
|
},
|
|
];
|
|
|
|
export async function execute(
|
|
this: IExecuteFunctions,
|
|
itemIndex: number,
|
|
): Promise<INodeExecutionData> {
|
|
const documentId = this.getNodeParameter('documentId', itemIndex) as string;
|
|
const returnAll = this.getNodeParameter('returnAll', itemIndex) as boolean;
|
|
const limit = this.getNodeParameter('limit', itemIndex, 50) as number;
|
|
const filters = this.getNodeParameter('filters', itemIndex, {}) as IDataObject;
|
|
|
|
const filter: IDataObject = {};
|
|
if ((filters.statuses as string[])?.length) filter.statuses = filters.statuses;
|
|
|
|
const hasFilter = Object.keys(filter).length > 0;
|
|
|
|
const query = `
|
|
query GetDocumentVersions($documentId: ID!, $first: Int, $after: CursorKey${hasFilter ? ', $filter: DocumentVersionFilter' : ''}) {
|
|
node(id: $documentId) {
|
|
... on Document {
|
|
versions(first: $first, after: $after${hasFilter ? ', filter: $filter' : ''}) {
|
|
edges {
|
|
node {
|
|
id
|
|
title
|
|
major
|
|
minor
|
|
status
|
|
content
|
|
changelog
|
|
classification
|
|
documentType
|
|
publishedAt
|
|
createdAt
|
|
updatedAt
|
|
}
|
|
}
|
|
pageInfo {
|
|
hasNextPage
|
|
endCursor
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
`;
|
|
|
|
const variables: IDataObject = { documentId };
|
|
if (hasFilter) variables.filter = filter;
|
|
|
|
const versions = await proboApiRequestAllItems.call(
|
|
this,
|
|
query,
|
|
variables,
|
|
(response) => {
|
|
const data = response?.data as IDataObject | undefined;
|
|
const node = data?.node as IDataObject | undefined;
|
|
return node?.versions as IDataObject | undefined;
|
|
},
|
|
returnAll,
|
|
limit,
|
|
);
|
|
|
|
return {
|
|
json: { versions },
|
|
pairedItem: { item: itemIndex },
|
|
};
|
|
}
|