n8n-nodes-didar-crm 0.0.15 → 0.0.17

package/README.md

@@ -1,35 +1,60 @@
 # n8n-nodes-didar-crm
 
-Custom **n8n nodes** for integrating with **Didar CRM**.
+Custom **n8n nodes** for integrating with **Didar CRM**.  
 This package provides actions and triggers to automate workflows with your Didar CRM account.
 
 ---
 
 ## ✨ Features
 
-* **Trigger**
+### Trigger
+- **Didar CRM Trigger** → receive webhook events for entity changes, updates, deletions.
 
-  * Receive webhook events from Didar CRM (entity changes, updates, deletions, etc.)
+### Deal
+- Create a deal
+- Update a deal (by Id)
+- Get deal details (by Id)
 
-* **Deal**
+### Person (Contact)
+- Create a person
+- Update a person (by Id)
+- Get person details (by Id)
 
-  * Create a deal
-  * Update a deal (by Id)
-  * Get deal details (by Id)
+### Company
+- Create a company
+- Update a company (by Id)
+- Get company details (by Id)
 
-* **Person (Contact)**
+### Activity
+- Create an activity
+- Update an activity (by Id)
 
-  * Create a person
-  * Update a person (by Id)
-  * Get person details (by Id)
+### Note
+- Create a note
+- Update a note (by Id)
 
-* **Common**
+### Case (Card)
+- Create a case
+- Update a case (by Id)
 
-  * Dropdown selectors for Pipelines, Pipeline Stages, Owners (Users)
-  * Manual ID input option for each dropdown field
-  * Support for additional fields like Source, Lost Reason, Visibility Type, Custom Fields, etc.
-  * Proper handling of default values (zero-guid where needed)
-  * Webhook trigger enforces POST requests
+### Product
+- Create a product
+- Update a product (by Id)
+- Get products by list of codes
+
+---
+
+## 🧩 Common Features
+
+- Dropdown selectors for Pipelines, Owners (Users), Activity Types, Product Categories, etc.
+- Manual ID input option for each dropdown field
+- Additional fields for advanced properties:
+  - Visibility Type
+  - Custom Fields (JSON)
+  - Multi-value lists (phones, emails, websites, addresses, bank accounts, labels, users)
+- Correct handling of defaults (zero GUIDs, booleans, etc.)
+- Webhook trigger enforces **POST** requests only
+- Consistent **Owner selection mechanism** (select from list or manual ID) across all resources
 
 ---
 
@@ -39,41 +64,61 @@ This package provides actions and triggers to automate workflows with your Didar
 npm install n8n-nodes-didar-crm
 ```
 
-Then, place the module inside your n8n custom directory (usually `~/.n8n/custom/`) and restart n8n.
+Place the module inside your n8n custom directory (usually `~/.n8n/custom/`) and restart n8n.
 
 ---
 
 ## ⚡ Usage
 
 ### 1. Trigger node
-
 Add the **Didar CRM Trigger** node to your workflow.
+- Exposes a webhook URL in n8n
+- Accepts **POST** requests only
+- Returns structured payload:
+
+```json
+{
+  "data": { ... },
+  "changes": [ ... ],
+  "meta": { ... },
+  "raw": { ... },
+  "receivedAt": "timestamp"
+}
+```
+
+### 2. Resource operations
+
+#### Deal
+- **Create** → required fields: `Title`, `OwnerId`, `PipelineId`, `PipelineStageId`
+- **Update** → same as create + `Id`
+- **Get** → requires `Id`
 
-* It exposes a webhook URL in n8n.
-* Only **POST** requests are accepted.
-* Returns payload structured into:
+#### Person (Contact)
+- **Create** → required fields: `LastName`, `OwnerId`
+- **Update** → same as create + `Id`
+- **Get** → requires `Id`
 
-  ```json
-  {
-    "data": { ... }, 
-    "changes": [ ... ], 
-    "meta": { ... }, 
-    "raw": { ... },
-    "receivedAt": "timestamp"
-  }
-  ```
+#### Company
+- **Create** → required fields: `Name`, `OwnerId`
+- **Update** → same as create + `Id`
+- **Get** → requires `Id`
 
-### 2. Deal operations
+#### Activity
+- **Create Activity** → required fields: `Title`, `OwnerId`, `ActivityTypeId`
+- **Update Activity** → same as create + `Id`
 
-* **Create Deal** → required fields: `Title`, `OwnerId`, `PipelineId`, `PipelineStageId`, `PersonId`, `CompanyId`, `Status`
-* **Update Deal** → same as Create, plus required `Id`
-* **Get Deal** → requires `Id`
+#### Note
+- **Create Note** → required fields: `ResultNote`, `OwnerId`
+- **Update Note** → same as create + `Id`
 
-### 3. Person (Contact) operations
+#### Case (Card)
+- **Create Case** → required fields: `Title`, `OwnerId`, `PipelineStageId`, `Status`
+- **Update Case** → same as create + `Id`
 
-* **Create Person** → required fields: `LastName`, `OwnerId`
-* **Update Person** → same as Create, plus required `Id`
-* **Get Person** → requires `Id`
+#### Product
+- **Create Product** → required fields: `Title`
+- **Update Product** → same as create + `Id`
+- **Get Products by Codes** → required field: `Code[]` (one or more codes)
 
 ---
 
@@ -81,8 +126,8 @@ Add the **Didar CRM Trigger** node to your workflow.
 
 A new credential type **Didar API** is provided.
 
-* You must set your **API Key** and (if required) authentication cookies.
-* Used across all operations.
+- Set your **API Key** and (if required) authentication cookies.
+- Shared across all nodes.
 
 ---
 
@@ -94,19 +139,18 @@ n8n-nodes-didar-crm/
 │── README.md
 │── LICENSE
 │── nodes/
-│    ├── DidarCrm.node.ts        # Main entry for resource & operation switch
+│    ├── DidarCrm.node.ts        # Main entry for resources & operations
 │    ├── DidarCrmTrigger.node.ts # Trigger node
-│    └── deal/                   # Deal operations
-│         ├── create.operation.ts
-│         ├── update.operation.ts
-│         └── get.operation.ts
-│    └── person/                 # Person operations
-│         ├── create.operation.ts
-│         ├── update.operation.ts
-│         └── get.operation.ts
+│    ├── deal/                   # Deal operations
+│    ├── person/                 # Person operations
+│    ├── company/                # Company operations
+│    ├── activity/               # Activity operations
+│    ├── note/                   # Note operations
+│    ├── case/                   # Case operations
+│    └── product/                # Product operations
 │── lib/
-     ├── http.ts                  # Request helper
-     └── loadOptions.ts           # Dropdown population (pipelines, stages, users)
+│    ├── http.ts                 # Request helper
+│    └── loadOptions.ts          # Dropdown population
 ```
 
 ---
@@ -124,7 +168,7 @@ n8n-nodes-didar-crm/
    ```bash
    npm run build
    ```
-4. Link into your n8n custom directory and restart n8n:
+4. Link into your n8n custom directory and restart:
 
    ```bash
    npm link

package/dist/nodes/DidarCrm.node.js

@@ -122,8 +122,8 @@ class DidarCrm {
                     displayOptions: { show: { resource: ['company'] } },
                     options: [
                         { name: 'Create', value: 'create', action: 'Create a company' },
-                        { name: 'Update', value: 'update', action: 'Update a company by Id' }, // NEW
-                        { name: 'Get', value: 'get', action: 'Get a company by Id' }, // NEW
+                        { name: 'Update', value: 'update', action: 'Update a company by Id' },
+                        { name: 'Get', value: 'get', action: 'Get a company by Id' },
                     ],
                     default: 'create',
                     description: 'Select the action to perform on the selected resource.',
@@ -135,7 +135,7 @@ class DidarCrm {
                     displayOptions: { show: { resource: ['activity'] } },
                     options: [
                         { name: 'Create', value: 'create', action: 'Create an activity' },
-                        { name: 'Update', value: 'update', action: 'Update an activity by Id' }, // NEW
+                        { name: 'Update', value: 'update', action: 'Update an activity by Id' },
                     ],
                     default: 'create',
                     description: 'Select the action to perform on the selected resource.',
@@ -172,6 +172,7 @@ class DidarCrm {
                     options: [
                         { name: 'Create', value: 'create', action: 'Create a product' },
                         { name: 'Update', value: 'update', action: 'Update a product by ID' },
+                        { name: 'Get by Codes', value: 'getByCodes', action: 'Get products by list of codes' },
                     ],
                     default: 'create',
                     description: 'Select the action to perform on the selected resource.',
@@ -200,6 +201,7 @@ class DidarCrm {
                 // Product properties (imported)
                 ...product_1.productCreateProperties,
                 ...product_1.productUpdateProperties,
+                ...product_1.productGetByCodesProperties,
             ],
         };
     }
@@ -245,11 +247,11 @@ class DidarCrm {
                 if (operation === 'update') {
                     await CompanyOps.companyUpdate.call(this, i, returnData);
                     continue;
-                } // NEW
+                }
                 if (operation === 'get') {
                     await CompanyOps.companyGet.call(this, i, returnData);
                     continue;
-                } // NEW
+                }
             }
             if (resource === 'activity') {
                 if (operation === 'create') {
@@ -259,7 +261,7 @@ class DidarCrm {
                 if (operation === 'update') {
                     await ActivityOps.activityUpdate.call(this, i, returnData);
                     continue;
-                } // NEW
+                }
             }
             if (resource === 'note') {
                 if (operation === 'create') {
@@ -289,7 +291,11 @@ class DidarCrm {
                 if (operation === 'update') {
                     await ProductOps.productUpdate.call(this, i, returnData);
                     continue;
-                } // NEW
+                }
+                if (operation === 'getByCodes') {
+                    await ProductOps.productGetByCodes.call(this, i, returnData);
+                    continue;
+                }
             }
         }
         return [returnData];

package/dist/nodes/activity/index.js

@@ -5,7 +5,7 @@ var create_operation_1 = require("./create.operation");
 Object.defineProperty(exports, "activityCreate", { enumerable: true, get: function () { return create_operation_1.activityCreate; } });
 var create_properties_1 = require("./create.properties");
 Object.defineProperty(exports, "activityCreateProperties", { enumerable: true, get: function () { return create_properties_1.activityCreateProperties; } });
-var update_operation_1 = require("./update.operation"); // NEW
+var update_operation_1 = require("./update.operation");
 Object.defineProperty(exports, "activityUpdate", { enumerable: true, get: function () { return update_operation_1.activityUpdate; } });
-var update_properties_1 = require("./update.properties"); // NEW
+var update_properties_1 = require("./update.properties");
 Object.defineProperty(exports, "activityUpdateProperties", { enumerable: true, get: function () { return update_properties_1.activityUpdateProperties; } });

package/dist/nodes/company/index.js

@@ -9,7 +9,7 @@ var update_operation_1 = require("./update.operation");
 Object.defineProperty(exports, "companyUpdate", { enumerable: true, get: function () { return update_operation_1.companyUpdate; } });
 var update_properties_1 = require("./update.properties");
 Object.defineProperty(exports, "companyUpdateProperties", { enumerable: true, get: function () { return update_properties_1.companyUpdateProperties; } });
-var get_operation_1 = require("./get.operation"); // NEW
+var get_operation_1 = require("./get.operation");
 Object.defineProperty(exports, "companyGet", { enumerable: true, get: function () { return get_operation_1.companyGet; } });
-var get_properties_1 = require("./get.properties"); // NEW
+var get_properties_1 = require("./get.properties");
 Object.defineProperty(exports, "companyGetProperties", { enumerable: true, get: function () { return get_properties_1.companyGetProperties; } });

package/dist/nodes/product/getByCodes.operation.d.ts

@@ -0,0 +1,2 @@
+import type { IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+export declare function productGetByCodes(this: IExecuteFunctions, i: number, returnData: INodeExecutionData[]): Promise<INodeExecutionData[]>;

package/dist/nodes/product/getByCodes.operation.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.productGetByCodes = productGetByCodes;
+const http_1 = require("../../lib/http");
+async function productGetByCodes(i, returnData) {
+    var _a;
+    // Read & normalize codes
+    const raw = this.getNodeParameter('Code', i, []);
+    const toArray = (v) => Array.isArray(v) ? v : (typeof v === 'string' && v ? [v] : []);
+    const codes = toArray(raw).map(s => (s !== null && s !== void 0 ? s : '').toString().trim()).filter(Boolean);
+    if (!codes.length)
+        throw new Error('At least one product code is required.');
+    const body = { Code: codes };
+    const resp = await (0, http_1.didarRequest)(this, i, {
+        method: 'POST',
+        path: '/api/product/getproductbycodes',
+        body,
+    });
+    // API returns { Response: { Total, Products: [...] } }
+    const out = ((_a = resp === null || resp === void 0 ? void 0 : resp.Response) !== null && _a !== void 0 ? _a : resp);
+    returnData.push({ json: out });
+    return returnData;
+}

package/dist/nodes/product/getByCodes.properties.d.ts

@@ -0,0 +1,2 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const productGetByCodesProperties: INodeProperties[];

package/dist/nodes/product/getByCodes.properties.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.productGetByCodesProperties = void 0;
+const showForProductGetByCodes = { show: { resource: ['product'], operation: ['getByCodes'] } };
+exports.productGetByCodesProperties = [
+    {
+        displayName: 'Codes',
+        name: 'Code',
+        type: 'string',
+        typeOptions: { multipleValues: true }, // n8n → string[]
+        default: [],
+        required: true,
+        displayOptions: showForProductGetByCodes,
+        description: 'List of product codes (at least one).',
+    },
+];

package/dist/nodes/product/index.d.ts

@@ -2,3 +2,5 @@ export { productCreate } from './create.operation';
 export { productCreateProperties } from './create.properties';
 export { productUpdate } from './update.operation';
 export { productUpdateProperties } from './update.properties';
+export { productGetByCodes } from './getByCodes.operation';
+export { productGetByCodesProperties } from './getByCodes.properties';

package/dist/nodes/product/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.productUpdateProperties = exports.productUpdate = exports.productCreateProperties = exports.productCreate = void 0;
+exports.productGetByCodesProperties = exports.productGetByCodes = exports.productUpdateProperties = exports.productUpdate = exports.productCreateProperties = exports.productCreate = void 0;
 // nodes/product/index.ts
 var create_operation_1 = require("./create.operation");
 Object.defineProperty(exports, "productCreate", { enumerable: true, get: function () { return create_operation_1.productCreate; } });
@@ -10,3 +10,7 @@ var update_operation_1 = require("./update.operation");
 Object.defineProperty(exports, "productUpdate", { enumerable: true, get: function () { return update_operation_1.productUpdate; } });
 var update_properties_1 = require("./update.properties");
 Object.defineProperty(exports, "productUpdateProperties", { enumerable: true, get: function () { return update_properties_1.productUpdateProperties; } });
+var getByCodes_operation_1 = require("./getByCodes.operation");
+Object.defineProperty(exports, "productGetByCodes", { enumerable: true, get: function () { return getByCodes_operation_1.productGetByCodes; } });
+var getByCodes_properties_1 = require("./getByCodes.properties");
+Object.defineProperty(exports, "productGetByCodesProperties", { enumerable: true, get: function () { return getByCodes_properties_1.productGetByCodesProperties; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-didar-crm",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "Didar CRM nodes for n8n (Trigger + Deal.create)",
   "author": "You",
   "license": "MIT",