n8n-nodes-didar-crm 0.0.16 → 0.0.18

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/lib/loadOptions.d.ts

@@ -1,6 +1,9 @@
 import { ILoadOptionsFunctions, INodePropertyOptions } from 'n8n-workflow';
 export declare function getPipelines(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
-export declare function getStagesForPipeline(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
+export declare function getStagesForPipeline(this: ILoadOptionsFunctions): Promise<{
+    name: string;
+    value: string;
+}[]>;
 export declare function getUsers(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
 export declare function getActivityTypes(this: ILoadOptionsFunctions): Promise<INodePropertyOptions[]>;
 export declare function getProductCategories(this: ILoadOptionsFunctions): Promise<any>;

package/dist/lib/loadOptions.js

@@ -29,7 +29,15 @@ async function getPipelines() {
 }
 async function getStagesForPipeline() {
     var _a, _b;
-    const pipelineId = String(this.getNodeParameter('PipelineIdSelect', '') || '');
+    // اول سعی کن از نام استاندارد search/ایجاد جدید بخوانی:
+    let pipelineId = this.getCurrentNodeParameter('pipelineId') || '';
+    // فالبک برای نودهای قدیمی/جداگانه که شاید اسم دیگری داشته باشند:
+    if (!pipelineId) {
+        try {
+            pipelineId = this.getCurrentNodeParameter('PipelineIdSelect') || '';
+        }
+        catch { }
+    }
     if (!pipelineId)
         return [];
     const creds = await this.getCredentials('didarApi');
@@ -44,6 +52,7 @@ async function getStagesForPipeline() {
         url,
         json: true,
         headers: { 'Content-Type': 'application/json' },
+        body: {}, // بعضی سرورها POST بدون body را دوست ندارند
     };
     if (useCookie && cookie)
         options.headers.Cookie = cookie;

package/dist/nodes/DidarCrm.node.js

@@ -98,6 +98,7 @@ class DidarCrm {
                         { name: 'Create', value: 'create', action: 'Create a deal' },
                         { name: 'Update', value: 'update', action: 'Update a deal by Id' },
                         { name: 'Get', value: 'get', action: 'Get a deal by Id' },
+                        { name: 'Search', value: 'search', action: 'Search deals' },
                     ],
                     default: 'create',
                     description: 'Select the action to perform on the selected resource.',
@@ -181,6 +182,7 @@ class DidarCrm {
                 ...deal_1.dealCreateProperties,
                 ...deal_1.dealUpdateProperties,
                 ...deal_1.dealGetProperties,
+                ...deal_1.dealSearchProperties,
                 // Person properties (imported)
                 ...person_1.personCreateProperties,
                 ...person_1.personUpdateProperties,
@@ -224,6 +226,10 @@ class DidarCrm {
                     await DealOps.dealGet.call(this, i, returnData);
                     continue;
                 }
+                if (operation === 'search') {
+                    await DealOps.dealSearch.call(this, i, returnData);
+                    continue;
+                }
             }
             if (resource === 'person') {
                 if (operation === 'create') {

package/dist/nodes/activity/create.operation.js

@@ -35,12 +35,100 @@ async function activityCreate(i, returnData) {
     const dealId = (_h = add.DealId) !== null && _h !== void 0 ? _h : '00000000-0000-0000-0000-000000000000';
     const caseId = (_j = add.CaseId) !== null && _j !== void 0 ? _j : '00000000-0000-0000-0000-000000000000';
     // ContactIds: string[]
-    let contactIds;
-    const cids = add.ContactIds;
-    if (Array.isArray(cids))
-        contactIds = cids.filter(Boolean);
-    else if (typeof cids === 'string' && cids)
-        contactIds = [cids];
+    // let contactIds: string[] | undefined;
+    // const cids = add.ContactIds as string[] | string | undefined;
+    // if (Array.isArray(cids)) contactIds = cids.filter(Boolean);
+    // else if (typeof cids === 'string' && cids) contactIds = [cids];
+    // ---- Robust ContactIds parsing: string | string[] | JSON array | CSV/newlines | [Array: [...]] ----
+    const rawContactIds = add.ContactIds;
+    const parseIdList = (input) => {
+        const out = [];
+        const pushFromString = (raw) => {
+            if (!raw)
+                return;
+            const s = raw.trim();
+            if (!s)
+                return;
+            // Handle n8n visualization: [Array: [...]]
+            const arrayLabel = s.match(/^\s*\[Array:\s*(\[[\s\S]*\])\s*\]\s*$/i);
+            if (arrayLabel) {
+                try {
+                    const arr = JSON.parse(arrayLabel[1]);
+                    recur(arr);
+                    return;
+                }
+                catch { /* fall through */ }
+            }
+            // JSON array
+            if (/^\s*\[/.test(s)) {
+                try {
+                    const arr = JSON.parse(s);
+                    recur(arr);
+                    return;
+                }
+                catch {
+                    throw new Error('Invalid JSON in "Contact IDs". Expected a JSON array of strings.');
+                }
+            }
+            // Otherwise CSV/newlines/semicolon
+            s.split(/[\n,;]+/)
+                .map((t) => t.trim())
+                .filter(Boolean)
+                .forEach((t) => out.push(t));
+        };
+        const recur = (val) => {
+            var _a, _b;
+            if (val == null)
+                return;
+            if (Array.isArray(val)) {
+                val.forEach(recur);
+                return;
+            }
+            switch (typeof val) {
+                case 'string':
+                    pushFromString(val);
+                    return;
+                case 'number':
+                case 'boolean':
+                    out.push(String(val));
+                    return;
+                case 'object': {
+                    const obj = val;
+                    // Map/Set support
+                    if (val instanceof Set) {
+                        recur(Array.from(val));
+                        return;
+                    }
+                    if (val instanceof Map) {
+                        recur(Array.from(val.values()));
+                        return;
+                    }
+                    // Common wrappers
+                    if (obj === null || obj === void 0 ? void 0 : obj.values) {
+                        recur(obj.values);
+                        return;
+                    }
+                    if (obj === null || obj === void 0 ? void 0 : obj.Value) {
+                        recur(obj.Value);
+                        return;
+                    }
+                    // Fallback: try toString
+                    const s = ((_b = (_a = obj === null || obj === void 0 ? void 0 : obj.toString) === null || _a === void 0 ? void 0 : _a.call(obj)) !== null && _b !== void 0 ? _b : '').toString();
+                    if (s)
+                        pushFromString(s);
+                    return;
+                }
+                default:
+                    return;
+            }
+        };
+        recur(input);
+        // Normalize and dedupe
+        return Array.from(new Set(out.map((x) => x.trim()).filter(Boolean)));
+    };
+    const contactIdsParsed = parseIdList(rawContactIds);
+    const contactIds = contactIdsParsed;
+    // Creator 
     const creatorId = (_k = add.CreatorId) !== null && _k !== void 0 ? _k : '00000000-0000-0000-0000-000000000000';
     const recurrenceType = (_l = add.RecurrenceType) !== null && _l !== void 0 ? _l : '';
     const recurrenceDataNum = Number((_m = add.RecurrenceData) !== null && _m !== void 0 ? _m : 0);

package/dist/nodes/activity/update.operation.js

@@ -37,12 +37,99 @@ async function activityUpdate(i, returnData) {
     const dealId = (_h = add.DealId) !== null && _h !== void 0 ? _h : '00000000-0000-0000-0000-000000000000';
     const caseId = (_j = add.CaseId) !== null && _j !== void 0 ? _j : '00000000-0000-0000-0000-000000000000';
     // ContactIds: string[]
-    let contactIds;
-    const cids = add.ContactIds;
-    if (Array.isArray(cids))
-        contactIds = cids.filter(Boolean);
-    else if (typeof cids === 'string' && cids)
-        contactIds = [cids];
+    // let contactIds: string[] | undefined;
+    // const cids = add.ContactIds as string[] | string | undefined;
+    // if (Array.isArray(cids)) contactIds = cids.filter(Boolean);
+    // else if (typeof cids === 'string' && cids) contactIds = [cids];
+    // ---- Robust ContactIds parsing: string | string[] | JSON array | CSV/newlines | [Array: [...]] ----
+    const rawContactIds = add.ContactIds;
+    const parseIdList = (input) => {
+        const out = [];
+        const pushFromString = (raw) => {
+            if (!raw)
+                return;
+            const s = raw.trim();
+            if (!s)
+                return;
+            // Handle n8n visualization: [Array: [...]]
+            const arrayLabel = s.match(/^\s*\[Array:\s*(\[[\s\S]*\])\s*\]\s*$/i);
+            if (arrayLabel) {
+                try {
+                    const arr = JSON.parse(arrayLabel[1]);
+                    recur(arr);
+                    return;
+                }
+                catch { /* fall through */ }
+            }
+            // JSON array
+            if (/^\s*\[/.test(s)) {
+                try {
+                    const arr = JSON.parse(s);
+                    recur(arr);
+                    return;
+                }
+                catch {
+                    throw new Error('Invalid JSON in "Contact IDs". Expected a JSON array of strings.');
+                }
+            }
+            // Otherwise CSV/newlines/semicolon
+            s.split(/[\n,;]+/)
+                .map((t) => t.trim())
+                .filter(Boolean)
+                .forEach((t) => out.push(t));
+        };
+        const recur = (val) => {
+            var _a, _b;
+            if (val == null)
+                return;
+            if (Array.isArray(val)) {
+                val.forEach(recur);
+                return;
+            }
+            switch (typeof val) {
+                case 'string':
+                    pushFromString(val);
+                    return;
+                case 'number':
+                case 'boolean':
+                    out.push(String(val));
+                    return;
+                case 'object': {
+                    const obj = val;
+                    // Map/Set support
+                    if (val instanceof Set) {
+                        recur(Array.from(val));
+                        return;
+                    }
+                    if (val instanceof Map) {
+                        recur(Array.from(val.values()));
+                        return;
+                    }
+                    // Common wrappers
+                    if (obj === null || obj === void 0 ? void 0 : obj.values) {
+                        recur(obj.values);
+                        return;
+                    }
+                    if (obj === null || obj === void 0 ? void 0 : obj.Value) {
+                        recur(obj.Value);
+                        return;
+                    }
+                    // Fallback: try toString
+                    const s = ((_b = (_a = obj === null || obj === void 0 ? void 0 : obj.toString) === null || _a === void 0 ? void 0 : _a.call(obj)) !== null && _b !== void 0 ? _b : '').toString();
+                    if (s)
+                        pushFromString(s);
+                    return;
+                }
+                default:
+                    return;
+            }
+        };
+        recur(input);
+        // Normalize and dedupe
+        return Array.from(new Set(out.map((x) => x.trim()).filter(Boolean)));
+    };
+    const contactIdsParsed = parseIdList(rawContactIds);
+    const contactIds = contactIdsParsed;
     const creatorId = (_k = add.CreatorId) !== null && _k !== void 0 ? _k : '00000000-0000-0000-0000-000000000000';
     const recurrenceType = (_l = add.RecurrenceType) !== null && _l !== void 0 ? _l : '';
     const recurrenceDataNum = Number((_m = add.RecurrenceData) !== null && _m !== void 0 ? _m : 0);

package/dist/nodes/case/create.operation.js

@@ -23,8 +23,104 @@ async function caseCreate(i, returnData) {
     const usersMode = this.getNodeParameter('UsersMode', i, 'select');
     const userIdsSelect = this.getNodeParameter('UserIdsSelect', i, []);
     const userIdsManual = this.getNodeParameter('UserIdsManual', i, []);
-    const toArray = (v) => Array.isArray(v) ? v : (typeof v === 'string' && v ? [v] : []);
-    const userIds = usersMode === 'select' ? toArray(userIdsSelect) : toArray(userIdsManual);
+    const toArray = (v) => Array.isArray(v)
+        ? v.map((x) => (x !== null && x !== void 0 ? x : '').toString().trim()).filter(Boolean)
+        : (typeof v === 'string' && v ? [v.trim()] : []);
+    // --- Robust parser for Manual input ---
+    const parseManualIds = (input) => {
+        const out = [];
+        const pushFromString = (raw) => {
+            if (!raw)
+                return;
+            const s = raw.trim();
+            if (!s)
+                return;
+            // Handle "[Array: [...]]" visualization
+            const arrayLabel = s.match(/^\s*\[Array:\s*(\[[\s\S]*\])\s*\]\s*$/i);
+            if (arrayLabel) {
+                try {
+                    const arr = JSON.parse(arrayLabel[1]);
+                    recur(arr);
+                    return;
+                }
+                catch { /* fall through */ }
+            }
+            // Try JSON array
+            if (/^\s*\[/.test(s)) {
+                try {
+                    const arr = JSON.parse(s);
+                    recur(arr);
+                    return;
+                }
+                catch {
+                    throw new Error('Invalid JSON in "User IDs (Manual)". Expected a JSON array of strings.');
+                }
+            }
+            // Otherwise treat as CSV/newline/semicolon separated
+            s.split(/[\n,;]+/)
+                .map((t) => t.trim())
+                .filter(Boolean)
+                .forEach((t) => out.push(t));
+        };
+        const recur = (val) => {
+            var _a, _b;
+            if (val == null)
+                return;
+            if (Array.isArray(val)) {
+                val.forEach(recur);
+                return;
+            }
+            switch (typeof val) {
+                case 'string':
+                    pushFromString(val);
+                    return;
+                case 'number':
+                case 'boolean':
+                    out.push(String(val));
+                    return;
+                case 'object': {
+                    // Common wrappers
+                    const obj = val;
+                    if (obj.values) {
+                        recur(obj.values);
+                        return;
+                    }
+                    if (obj.Value) {
+                        recur(obj.Value);
+                        return;
+                    }
+                    // Map/Set support
+                    if (val instanceof Set) {
+                        recur(Array.from(val));
+                        return;
+                    }
+                    if (val instanceof Map) {
+                        recur(Array.from(val.values()));
+                        return;
+                    }
+                    // Fallback: string representation
+                    const s = ((_b = (_a = obj === null || obj === void 0 ? void 0 : obj.toString) === null || _a === void 0 ? void 0 : _a.call(obj)) !== null && _b !== void 0 ? _b : '').toString();
+                    if (s)
+                        pushFromString(s);
+                    return;
+                }
+                default:
+                    return;
+            }
+        };
+        recur(input);
+        // Normalize & dedupe
+        return Array.from(new Set(out.map((x) => x.trim()).filter(Boolean)));
+    };
+    const usersFromSelect = toArray(userIdsSelect);
+    const usersFromManual = parseManualIds(userIdsManual);
+    // Final pick based on UsersMode
+    let userIds = usersMode === 'select' ? usersFromSelect : usersFromManual;
+    // Optional: strict GUID validation (enable if needed)
+    // const guidRe = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    // userIds = userIds.filter(id => guidRe.test(id));
+    userIds = Array.from(new Set(userIds)).filter(Boolean);
+    // resultNote
     const resultNoteTop = status === 'Done' ? this.getNodeParameter('ResultNote', i, '') : '';
     // Additional
     const add = this.getNodeParameter('additionalFields', i, {}) || {};

package/dist/nodes/case/create.properties.js

@@ -95,7 +95,7 @@ exports.caseCreateProperties = [
         typeOptions: { multipleValues: true },
         default: [],
         displayOptions: { show: { ...showForCaseCreate.show, UsersMode: ['manual'] } },
-        description: 'Enter one or more user IDs (GUIDs).',
+        description: 'Enter one or more user IDs (GUIDs or GUIDs,GUIDs or [GUIDs,GUIDs]). Accepts multiple fields, CSV/newlines, JSON array, or an expression returning an array.',
     },
     {
         displayName: 'Result Note',
@@ -150,7 +150,8 @@ exports.caseCreateProperties = [
             { displayName: 'Custom Fields (JSON)', name: 'Fields', type: 'json', default: '', placeholder: '{ "Field_XXXX_0_YY": "value" }', description: 'JSON object of custom fields.' },
             // string[]
             { displayName: 'Label IDs', name: 'LabelIds', type: 'string', typeOptions: { multipleValues: true }, default: [], description: 'Label IDs to be set on the case.' },
-            { displayName: 'Visibility Type', name: 'VisibilityType', type: 'options',
+            {
+                displayName: 'Visibility Type', name: 'VisibilityType', type: 'options',
                 options: [
                     { name: 'Owner', value: 'Owner' },
                     { name: 'Owner Group', value: 'OwnerGroup' },