n8n-nodes-vtiger-oss 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 n8n-nodes-vtiger-oss contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,262 @@
+# n8n-nodes-vtiger-oss
+
+An n8n community node for Vtiger CRM Open Source 8.x. It gives workflows authenticated access to
+Vtiger's webservice API with dedicated actions for records, documents, relations, VTQL queries,
+module metadata, and lead conversion.
+
+The package targets n8n 2.x and Node.js 22.22 or 24. Loading of the packaged node is tested against
+n8n 2.34.5. Core read operations have been verified on fresh Vtiger 8.0 through 8.4 installations;
+known limitations are listed under [Compatibility](#compatibility).
+
+## Resources and Operations
+
+The names below match what you see in n8n.
+
+| Resource           | Operations                                                                              |
+| ------------------ | --------------------------------------------------------------------------------------- |
+| **Advanced**       | Custom GET, Custom POST                                                                 |
+| **Document**       | Download Attachment, Upload, Upload and Link to Record                                  |
+| **Lead**           | Convert                                                                                 |
+| **Module**         | Describe Module, List Accessible Modules                                                |
+| **Query**          | Guided VTQL Query, Raw VTQL Query                                                       |
+| **Record**         | Create, Delete, Full Update, Retrieve, Update Fields                                    |
+| **Related Record** | Add Related Record, List Related Types, Query Related Records, Retrieve Related Records |
+
+Records are referenced by their full Vtiger webservice ID in the form
+`<entity-type-prefix>x<record-number>`, for example `11x123`. The prefix depends on the
+installation, and the plain numeric ID from a CRM URL is not enough. A few inventory fields are
+exceptions – `currency_id`, for instance, usually takes the internal numeric currency ID. When in
+doubt, check the module metadata or an existing record in your installation.
+
+### Record Operations
+
+**Record** covers generic CRUD for any module the API user can access, including inventory modules
+as long as you supply the full payload the installation expects.
+
+- **Update Fields** uses Vtiger's `revise` operation. Only the fields you send are changed;
+  everything else stays as it is.
+- **Full Update** uses Vtiger's `update` operation. You must send every mandatory field and every
+  value you want to keep.
+
+Use **Update Fields** unless you specifically need the full-update behavior.
+After a successful **Delete**, the node returns `{ "deleted": true }`.
+
+### Output
+
+Actions that return records or metadata provide three output modes:
+
+- **Simplified** is the default. It returns up to ten top-level fields and prioritizes common
+  identity fields such as `id`, names, labels, and email addresses.
+- **Raw** returns every top-level field provided by Vtiger.
+- **Selected Fields** returns only the comma-separated top-level fields you request.
+
+Each record in a list remains a separate n8n item. File downloads and action confirmations are not
+filtered by these modes.
+
+### Quotes, Invoices, Sales Orders, and Purchase Orders
+
+These modules work with the normal **Record** operations. **Retrieve** returns the `LineItems`
+collection. **Update Fields** keeps existing line items when `LineItems` is omitted and replaces
+them when a non-empty collection is supplied.
+
+Vtiger also registers a `retrieve_inventory` operation, but it returns nothing beyond the regular
+`retrieve`. When updating a record in a foreign currency, include its current `conversion_rate` –
+otherwise Vtiger's inventory handler may fall back to `1`.
+
+A Quote create payload typically looks like this:
+
+```json
+{
+	"subject": "Example Quote",
+	"quotestage": "Created",
+	"account_id": "11x123",
+	"assigned_user_id": "19x1",
+	"currency_id": "1",
+	"conversion_rate": "1",
+	"hdnTaxType": "group",
+	"productid": "14x456",
+	"quantity": "1",
+	"listprice": "100.00",
+	"LineItems": [
+		{
+			"productid": "14x456",
+			"quantity": "1",
+			"listprice": "100.00",
+			"discount_percent": "0",
+			"discount_amount": "0",
+			"comment": "Example line item"
+		}
+	]
+}
+```
+
+Treat this as a structural example rather than a ready-to-run payload. Use **Describe Module** to
+get the actual field list, and take IDs, picklist values, currencies, taxes, custom fields, and any
+further mandatory fields from your installation. The parent-level `productid`, `quantity`, and
+`listprice` are the minimum; some installations also expect the first line item's comment,
+discounts, taxes, purchase cost, margin, or other values at parent level.
+
+### Lead Conversion
+
+Vtiger creates the selected Account, Contact, and Potential one after another. If a later step
+fails, the records created before it remain while the Lead stays unconverted. A missing required
+Potential field, for example, can leave behind a Contact that was already created.
+
+### VTQL Queries
+
+Both query operations run VTQL `SELECT` statements with offset-based pagination.
+
+- **Guided VTQL Query** builds `SELECT *`, `FROM`, `WHERE`, and `ORDER BY` from separate fields.
+  Enter the condition only, without the `WHERE` keyword.
+- **Raw VTQL Query** takes the complete `SELECT` statement.
+
+Control the result size with **Limit** or **Return All**. The node turns these settings into the
+`LIMIT` clause, so leave `LIMIT` out of the raw query text. Queries that need more than one API
+request must have a stable `ORDER BY`, and records changing mid-query can still affect offset-based
+results.
+
+### Documents and Attachments
+
+**Upload** creates a `Documents` record with an internally stored file. **Upload and Link to
+Record** creates the document first and then relates it to an existing record. If linking fails,
+the document is kept and its ID is included in the error message so you can clean up.
+
+Vtiger uses two different identifiers here:
+
+- The Document ID (`result.id`) is used for retrieval, deletion, and relations.
+- The Attachment Download ID (`imageattachmentids`) is used by **Download Attachment** via
+  `files_retrieve`.
+
+Downloads are returned as n8n binary data. The aggregate download limit is configurable, defaults
+to 25 MB, and is capped at 100 MB.
+
+### Related Records
+
+Start with **List Related Types** to get the exact related module and related-list label the
+installation expects, then use that label with the other operations:
+
+- **Retrieve Related Records** returns a related list for a parent record.
+- **Query Related Records** runs a VTQL query within a related list. An optional `LIMIT` clause is
+  passed through to Vtiger as-is; there is no automatic pagination.
+- **Add Related Record** links two existing records.
+
+Vtiger has no standard webservice operation for removing a relation, so the node does not offer
+one.
+
+### Advanced Operations
+
+**Custom GET** and **Custom POST** call any operation registered in the Vtiger installation. The
+node protects the internally managed operation and session parameters, but the operations
+themselves are not allowlisted and can change or delete data.
+
+## Installation
+
+Install `n8n-nodes-vtiger-oss` from **Settings > Community Nodes** in n8n. For a manual
+self-hosted installation, run this inside `~/.n8n/nodes`:
+
+```sh
+npm install n8n-nodes-vtiger-oss
+```
+
+Restart n8n, add the **Vtiger Open Source API** credential, and select **Vtiger Open Source** in a
+workflow.
+
+## Credentials
+
+Create a dedicated Vtiger API user with only the permissions your workflows need. Enter the
+installation base URL, the username, and the access key from the user's Vtiger preferences – not
+the account password.
+
+HTTPS is required by default. **Allow Insecure HTTP** exists only for isolated local test systems
+and should never be enabled on production credentials. n8n stores the access key in its encrypted
+credential store.
+
+When the node is used as an AI tool, the generic Record actions can create, update, and delete data
+within the API user's permissions. Keep that user least-privilege and only expose mutating tools
+where the workflow actually needs them.
+
+## Compatibility
+
+Compatibility is operation-specific. Fresh-install probes confirmed login, module metadata,
+relation metadata, and ordered VTQL queries on Vtiger 8.0 through 8.4; targeted integration tests
+cover further read behavior. Newer Vtiger 8.x releases are not assumed to work without testing.
+The lab setup, probe generator, and retained matrix results are available in
+[hwjf/vtiger-oss-lab](https://github.com/hwjf/vtiger-oss-lab).
+
+### Fresh Installations
+
+| Vtiger version | Status                                                                  |
+| -------------- | ----------------------------------------------------------------------- |
+| 8.0 – 8.3      | Core read probes pass; `files_retrieve` is broken under PHP 8           |
+| 8.4            | Core read probes pass; `files_retrieve` handler signature is compatible |
+
+- Fresh 8.0 through 8.3 installations register `files_retrieve` with an `id` parameter while the
+  PHP handler expects `$file_id`. Vtiger 8.4 fixes this.
+- Lead conversion requires the current registration with a single encoded `element` parameter.
+
+### Upgraded Installations
+
+An upgraded installation can behave differently from a fresh one reporting the same version.
+Database registrations and old customizations may survive several upgrades even after the PHP
+handlers have changed. One example seen in practice is an obsolete five-parameter `convertlead`
+registration.
+
+## Example
+
+A read-only workflow you can import is available at
+[`examples/list-accessible-modules.workflow.json`](https://github.com/hwjf/n8n-nodes-vtiger-oss/blob/main/examples/list-accessible-modules.workflow.json).
+Import it, assign your **Vtiger Open Source API** credential, and run it manually.
+
+## Development
+
+Clone the repository, then:
+
+```sh
+npm ci
+npm run format:check
+npm run lint
+npm test
+npm run test:coverage
+npm run build
+```
+
+`npm run dev` loads the package into a local n8n development instance.
+
+For integration tests, copy
+[`.env.example`](https://github.com/hwjf/n8n-nodes-vtiger-oss/blob/main/.env.example) to `.env`,
+enter the credentials of a dedicated Vtiger test user, and run `npm run test:integration`.
+Optional record and attachment IDs enable additional read tests. Mutating tests require separate
+explicit flags and an isolated test instance – never point them at production.
+
+There is also a
+[packaged-node smoke test](https://github.com/hwjf/n8n-nodes-vtiger-oss/tree/main/test/n8n) that
+builds the package, installs it into n8n 2.34.5, and verifies that the node loads against n8n's
+own `n8n-workflow` installation.
+
+## Troubleshooting
+
+- **Credential test fails:** Enter the base URL without `/webservice.php`, double-check the access
+  key, and use HTTPS.
+- **Invalid record ID:** Use the full webservice ID returned by Vtiger or this node, not the
+  numeric ID from a CRM URL.
+- **Permission to perform the operation is denied:** Make sure the module is active and the API
+  user can access the module, the record, any referenced users, and all related modules involved.
+  Vtiger also returns this message when a module such as Leads is disabled.
+- **HTTP 500 on attachments or lead conversion:** See the compatibility notes and check the
+  `vtiger_ws_operation` table. Upgraded installations can carry incompatible registrations.
+- **A query stops at 100 records:** Enable **Return All** or raise **Limit**. The node converts
+  this into the `LIMIT` clause; multi-page queries also need an `ORDER BY`.
+- **Execution continues after an item error:** Disable n8n's **Continue On Fail** if the workflow
+  should stop at the first failed item.
+- **Local development fails on Node 23:** Use Node.js 22.22 LTS or 24. Odd-numbered Node.js
+  releases are not supported by the toolchain.
+
+## Trademarks
+
+Vtiger and the Vtiger logo are trademarks of their respective owner and are used here only to
+indicate compatibility with Vtiger CRM. This is an independent community project and is not
+affiliated with or endorsed by Vtiger.
+
+## License
+
+[MIT](https://github.com/hwjf/n8n-nodes-vtiger-oss/blob/main/LICENSE)

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,29 @@
+# Third-Party Notices
+
+## Vtiger Logo Mark
+
+The Vtiger logo mark in `nodes/VtigerOss/vtigerOss.svg` is adapted from:
+
+https://github.com/sogjugz/n8n-nodes-vtiger-crm/blob/master/nodes/Vtiger/vtiger.svg
+
+That repository distributes its software under the MIT License:
+
+Copyright 2022 n8n
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT
+OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Vtiger and the Vtiger logo are trademarks of their respective owner. Their use does not imply
+affiliation with or endorsement of this community project.

package/dist/credentials/VtigerOssApi.credentials.d.ts

@@ -0,0 +1,8 @@
+import type { Icon, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class VtigerOssApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    icon: Icon;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/VtigerOssApi.credentials.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VtigerOssApi = void 0;
+class VtigerOssApi {
+    constructor() {
+        this.name = 'vtigerOssApi';
+        this.displayName = 'Vtiger Open Source API';
+        this.icon = {
+            light: 'file:../nodes/VtigerOss/vtigerOss.svg',
+            dark: 'file:../nodes/VtigerOss/vtigerOss.dark.svg',
+        };
+        this.documentationUrl = 'https://github.com/hwjf/n8n-nodes-vtiger-oss#credentials';
+        this.properties = [
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: '',
+                placeholder: 'e.g. https://vtiger.example.com/vtigercrm',
+                description: 'Root URL of the Vtiger installation, including any installation subdirectory and excluding /webservice.php',
+                required: true,
+            },
+            {
+                displayName: 'Username',
+                name: 'username',
+                type: 'string',
+                default: '',
+                required: true,
+            },
+            {
+                displayName: 'Access Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                description: 'Access key from the Vtiger user preferences, not the account password',
+                required: true,
+            },
+            {
+                displayName: 'Allow Insecure HTTP',
+                name: 'allowInsecureHttp',
+                type: 'boolean',
+                default: false,
+                description: 'Whether to allow unencrypted HTTP connections. Enable only for isolated development systems.',
+            },
+        ];
+    }
+}
+exports.VtigerOssApi = VtigerOssApi;
+//# sourceMappingURL=VtigerOssApi.credentials.js.map

package/dist/credentials/VtigerOssApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VtigerOssApi.credentials.js","sourceRoot":"","sources":["../../credentials/VtigerOssApi.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IAAzB;QACC,SAAI,GAAG,cAAc,CAAC;QAEtB,gBAAW,GAAG,wBAAwB,CAAC;QAEvC,SAAI,GAAS;YACZ,KAAK,EAAE,uCAAuC;YAC9C,IAAI,EAAE,4CAA4C;SAClD,CAAC;QAEF,qBAAgB,GAAG,0DAA0D,CAAC;QAE9E,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,2CAA2C;gBACxD,WAAW,EACV,4GAA4G;gBAC7G,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,uEAAuE;gBACpF,QAAQ,EAAE,IAAI;aACd;YACD;gBACC,WAAW,EAAE,qBAAqB;gBAClC,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EACV,8FAA8F;aAC/F;SACD,CAAC;IACH,CAAC;CAAA;AAhDD,oCAgDC"}

package/dist/nodes/VtigerOss/VtigerOss.node.d.ts

@@ -0,0 +1,11 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+import { testVtigerCredentials } from './transport/credentialTest';
+export declare class VtigerOss implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        credentialTest: {
+            testVtigerCredentials: typeof testVtigerCredentials;
+        };
+    };
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/VtigerOss/VtigerOss.node.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VtigerOss = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const properties_1 = require("./actions/properties");
+const router_1 = require("./actions/router");
+const types_1 = require("./actions/types");
+const output_1 = require("./helpers/output");
+const client_1 = require("./transport/client");
+const credentialTest_1 = require("./transport/credentialTest");
+class VtigerOss {
+    constructor() {
+        this.description = {
+            displayName: 'Vtiger Open Source',
+            name: 'vtigerOss',
+            icon: { light: 'file:vtigerOss.svg', dark: 'file:vtigerOss.dark.svg' },
+            group: ['transform'],
+            version: 1,
+            description: 'Interact with Vtiger CRM Open Source',
+            subtitle: '={{$parameter["resource"] + ": " + $parameter["operation"]}}',
+            defaults: {
+                name: 'Vtiger Open Source',
+            },
+            inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            usableAsTool: true,
+            credentials: [
+                {
+                    name: 'vtigerOssApi',
+                    required: true,
+                    testedBy: 'testVtigerCredentials',
+                },
+            ],
+            properties: properties_1.actionProperties,
+        };
+        this.methods = {
+            credentialTest: {
+                testVtigerCredentials: credentialTest_1.testVtigerCredentials,
+            },
+        };
+    }
+    async execute() {
+        const inputItems = this.getInputData();
+        if (inputItems.length === 0)
+            return [[]];
+        const client = await client_1.VtigerClient.create(this);
+        const outputItems = [];
+        for (let itemIndex = 0; itemIndex < inputItems.length; itemIndex++) {
+            try {
+                const resource = this.getNodeParameter('resource', itemIndex);
+                const operation = this.getNodeParameter('operation', itemIndex);
+                const result = await (0, router_1.routeAction)({ context: this, client, itemIndex });
+                const outputMode = (0, output_1.actionSupportsOutput)(resource, operation)
+                    ? this.getNodeParameter('output', itemIndex, 'simplified')
+                    : 'raw';
+                const selectedFields = outputMode === 'selected'
+                    ? (0, output_1.parseSelectedFields)(this.getNodeParameter('fieldsToInclude', itemIndex, ''))
+                    : [];
+                for (const output of (0, types_1.asOutputItems)(result)) {
+                    outputItems.push({
+                        ...output,
+                        json: (0, output_1.formatOutput)(output.json, outputMode, selectedFields),
+                        pairedItem: itemIndex,
+                    });
+                }
+            }
+            catch (error) {
+                const nodeError = new n8n_workflow_1.NodeOperationError(this.getNode(), error instanceof Error ? error : new Error('Unknown Vtiger error'), { itemIndex });
+                if (!this.continueOnFail())
+                    throw nodeError;
+                outputItems.push({
+                    json: inputItems[itemIndex].json,
+                    error: nodeError,
+                    pairedItem: itemIndex,
+                });
+            }
+        }
+        return [outputItems];
+    }
+}
+exports.VtigerOss = VtigerOss;
+//# sourceMappingURL=VtigerOss.node.js.map

package/dist/nodes/VtigerOss/VtigerOss.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VtigerOss.node.js","sourceRoot":"","sources":["../../../nodes/VtigerOss/VtigerOss.node.ts"],"names":[],"mappings":"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"}

package/dist/nodes/VtigerOss/VtigerOss.node.json

@@ -0,0 +1,18 @@
+{
+    "node": "n8n-nodes-vtiger-oss.vtigerOss",
+    "nodeVersion": "1.0",
+    "codexVersion": "1.0",
+    "categories": ["Sales", "Productivity"],
+    "resources": {
+        "credentialDocumentation": [
+            {
+                "url": "https://github.com/hwjf/n8n-nodes-vtiger-oss#credentials"
+            }
+        ],
+        "primaryDocumentation": [
+            {
+                "url": "https://github.com/hwjf/n8n-nodes-vtiger-oss#readme"
+            }
+        ]
+    }
+}

package/dist/nodes/VtigerOss/actions/advanced/customGet.action.d.ts

@@ -0,0 +1,2 @@
+import type { ActionHandler } from '../types';
+export declare const customGet: ActionHandler;

package/dist/nodes/VtigerOss/actions/advanced/customGet.action.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.customGet = void 0;
+const advanced_1 = require("../../helpers/advanced");
+const customGet = async ({ context, client, itemIndex }) => {
+    const operation = (0, advanced_1.validateCustomOperation)(context.getNodeParameter('customOperation', itemIndex));
+    const parameters = (0, advanced_1.serializeCustomParameters)(context.getNodeParameter('customParameters', itemIndex));
+    return await client.request({ method: 'GET', operation, parameters });
+};
+exports.customGet = customGet;
+//# sourceMappingURL=customGet.action.js.map

package/dist/nodes/VtigerOss/actions/advanced/customGet.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customGet.action.js","sourceRoot":"","sources":["../../../../../nodes/VtigerOss/actions/advanced/customGet.action.ts"],"names":[],"mappings":";;;AACA,qDAA4F;AAErF,MAAM,SAAS,GAAkB,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;IAChF,MAAM,SAAS,GAAG,IAAA,kCAAuB,EACxC,OAAO,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,SAAS,CAAW,CAChE,CAAC;IACF,MAAM,UAAU,GAAG,IAAA,oCAAyB,EAC3C,OAAO,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,SAAS,CAAC,CACvD,CAAC;IACF,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;AACvE,CAAC,CAAC;AARW,QAAA,SAAS,aAQpB"}

package/dist/nodes/VtigerOss/actions/advanced/customPost.action.d.ts

@@ -0,0 +1,2 @@
+import type { ActionHandler } from '../types';
+export declare const customPost: ActionHandler;

package/dist/nodes/VtigerOss/actions/advanced/customPost.action.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.customPost = void 0;
+const advanced_1 = require("../../helpers/advanced");
+const customPost = async ({ context, client, itemIndex }) => {
+    const operation = (0, advanced_1.validateCustomOperation)(context.getNodeParameter('customOperation', itemIndex));
+    const parameters = (0, advanced_1.serializeCustomParameters)(context.getNodeParameter('customParameters', itemIndex));
+    return await client.request({ method: 'POST', operation, parameters });
+};
+exports.customPost = customPost;
+//# sourceMappingURL=customPost.action.js.map

package/dist/nodes/VtigerOss/actions/advanced/customPost.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customPost.action.js","sourceRoot":"","sources":["../../../../../nodes/VtigerOss/actions/advanced/customPost.action.ts"],"names":[],"mappings":";;;AACA,qDAA4F;AAErF,MAAM,UAAU,GAAkB,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;IACjF,MAAM,SAAS,GAAG,IAAA,kCAAuB,EACxC,OAAO,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,SAAS,CAAW,CAChE,CAAC;IACF,MAAM,UAAU,GAAG,IAAA,oCAAyB,EAC3C,OAAO,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,SAAS,CAAC,CACvD,CAAC;IACF,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;AACxE,CAAC,CAAC;AARW,QAAA,UAAU,cAQrB"}

package/dist/nodes/VtigerOss/actions/document/download.action.d.ts

@@ -0,0 +1,2 @@
+import type { ActionHandler } from '../types';
+export declare const downloadAttachment: ActionHandler;

package/dist/nodes/VtigerOss/actions/document/download.action.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadAttachment = void 0;
+const types_1 = require("../types");
+const file_1 = require("../../helpers/file");
+const webserviceId_1 = require("../../helpers/webserviceId");
+const downloadAttachment = async ({ context, client, itemIndex }) => {
+    const id = (0, webserviceId_1.validateWebserviceId)(context.getNodeParameter('attachmentId', itemIndex));
+    const binaryPropertyName = context.getNodeParameter('binaryPropertyName', itemIndex);
+    const maximumMegabytes = context.getNodeParameter('maximumFileSize', itemIndex);
+    const maximumBytes = (0, file_1.maximumFileSizeInBytes)(maximumMegabytes);
+    const result = await client.request({
+        method: 'GET',
+        operation: 'files_retrieve',
+        parameters: { id },
+    });
+    const files = (0, file_1.parseRetrievedFiles)(result, maximumBytes);
+    const outputs = [];
+    for (const file of files) {
+        const binaryData = await context.helpers.prepareBinaryData(file.data, file.fileName, file.mimeType);
+        outputs.push((0, types_1.createActionOutput)({
+            fileId: file.fileId,
+            fileName: file.fileName,
+            mimeType: file.mimeType,
+            fileSize: file.fileSize,
+        }, { [binaryPropertyName]: binaryData }));
+    }
+    return outputs;
+};
+exports.downloadAttachment = downloadAttachment;
+//# sourceMappingURL=download.action.js.map

package/dist/nodes/VtigerOss/actions/document/download.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.action.js","sourceRoot":"","sources":["../../../../../nodes/VtigerOss/actions/document/download.action.ts"],"names":[],"mappings":";;;AACA,oCAA8C;AAC9C,6CAAiF;AACjF,6DAAkE;AAE3D,MAAM,kBAAkB,GAAkB,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;IACzF,MAAM,EAAE,GAAG,IAAA,mCAAoB,EAAC,OAAO,CAAC,gBAAgB,CAAC,cAAc,EAAE,SAAS,CAAW,CAAC,CAAC;IAC/F,MAAM,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,oBAAoB,EAAE,SAAS,CAAW,CAAC;IAC/F,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,SAAS,CAAW,CAAC;IAC1F,MAAM,YAAY,GAAG,IAAA,6BAAsB,EAAC,gBAAgB,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACnC,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,gBAAgB;QAC3B,UAAU,EAAE,EAAE,EAAE,EAAE;KAClB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,IAAA,0BAAmB,EAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,EAAE,CAAC;IAEnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,iBAAiB,CACzD,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,QAAQ,CACb,CAAC;QACF,OAAO,CAAC,IAAI,CACX,IAAA,0BAAkB,EACjB;YACC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACvB,EACD,EAAE,CAAC,kBAAkB,CAAC,EAAE,UAAU,EAAE,CACpC,CACD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC;AAjCW,QAAA,kBAAkB,sBAiC7B"}

package/dist/nodes/VtigerOss/actions/document/upload.action.d.ts

@@ -0,0 +1,4 @@
+import type { ActionContext, ActionHandler } from '../types';
+import type { UploadedDocument } from '../../helpers/document';
+export declare function uploadDocument({ context, client, itemIndex, }: ActionContext): Promise<UploadedDocument>;
+export declare const upload: ActionHandler;

package/dist/nodes/VtigerOss/actions/document/upload.action.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.upload = void 0;
+exports.uploadDocument = uploadDocument;
+const document_1 = require("../../helpers/document");
+const file_1 = require("../../helpers/file");
+const serialization_1 = require("../../helpers/serialization");
+async function uploadDocument({ context, client, itemIndex, }) {
+    const binaryPropertyName = context.getNodeParameter('binaryPropertyName', itemIndex);
+    const binaryData = context.helpers.assertBinaryData(itemIndex, binaryPropertyName);
+    const fileName = (0, document_1.validateUploadFileName)(binaryData.fileName);
+    const file = await context.helpers.getBinaryDataBuffer(itemIndex, binaryPropertyName);
+    const maximumBytes = (0, file_1.maximumFileSizeInBytes)(context.getNodeParameter('maximumFileSize', itemIndex), 'Maximum Upload Size', 'create');
+    (0, document_1.assertUploadSize)(file.length, maximumBytes);
+    const element = (0, document_1.buildDocumentElement)({
+        title: context.getNodeParameter('documentTitle', itemIndex, ''),
+        fileName,
+        assignedToId: context.getNodeParameter('assignedToId', itemIndex),
+        folderId: context.getNodeParameter('folderId', itemIndex),
+        fileStatus: context.getNodeParameter('fileStatus', itemIndex),
+        additionalFields: context.getNodeParameter('documentFields', itemIndex, '{}'),
+    });
+    const result = await client.requestMultipart({
+        operation: 'create',
+        parameters: {
+            elementType: 'Documents',
+            element: (0, serialization_1.encodeElement)(element),
+            filename_hidden: fileName,
+        },
+        file: {
+            fieldName: 'filename',
+            data: file,
+            fileName,
+            mimeType: binaryData.mimeType,
+        },
+    });
+    return (0, document_1.normalizeUploadedDocument)(result);
+}
+const upload = async (actionContext) => await uploadDocument(actionContext);
+exports.upload = upload;
+//# sourceMappingURL=upload.action.js.map

package/dist/nodes/VtigerOss/actions/document/upload.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.action.js","sourceRoot":"","sources":["../../../../../nodes/VtigerOss/actions/document/upload.action.ts"],"names":[],"mappings":";;;AAWA,wCAuCC;AAhDD,qDAKgC;AAChC,6CAA4D;AAC5D,+DAA4D;AAErD,KAAK,UAAU,cAAc,CAAC,EACpC,OAAO,EACP,MAAM,EACN,SAAS,GACM;IACf,MAAM,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,oBAAoB,EAAE,SAAS,CAAW,CAAC;IAC/F,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,IAAA,iCAAsB,EAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IACtF,MAAM,YAAY,GAAG,IAAA,6BAAsB,EAC1C,OAAO,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,SAAS,CAAW,EAChE,qBAAqB,EACrB,QAAQ,CACR,CAAC;IACF,IAAA,2BAAgB,EAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAA,+BAAoB,EAAC;QACpC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,eAAe,EAAE,SAAS,EAAE,EAAE,CAAW;QACzE,QAAQ;QACR,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,cAAc,EAAE,SAAS,CAAW;QAC3E,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,UAAU,EAAE,SAAS,CAAW;QACnE,UAAU,EAAE,OAAO,CAAC,gBAAgB,CAAC,YAAY,EAAE,SAAS,CAAY;QACxE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,SAAS,EAAE,IAAI,CAAC;KAC7E,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC;QAC5C,SAAS,EAAE,QAAQ;QACnB,UAAU,EAAE;YACX,WAAW,EAAE,WAAW;YACxB,OAAO,EAAE,IAAA,6BAAa,EAAC,OAAO,CAAC;YAC/B,eAAe,EAAE,QAAQ;SACzB;QACD,IAAI,EAAE;YACL,SAAS,EAAE,UAAU;YACrB,IAAI,EAAE,IAAI;YACV,QAAQ;YACR,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC7B;KACD,CAAC,CAAC;IAEH,OAAO,IAAA,oCAAyB,EAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAEM,MAAM,MAAM,GAAkB,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC,MAAM,cAAc,CAAC,aAAa,CAAC,CAAC;AAArF,QAAA,MAAM,UAA+E"}

package/dist/nodes/VtigerOss/actions/document/uploadAndLink.action.d.ts

@@ -0,0 +1,2 @@
+import type { ActionHandler } from '../types';
+export declare const uploadAndLink: ActionHandler;