n8n-nodes-openmrs 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Monfort N. Brian
+
+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,367 @@
+# n8n-nodes-openmrs
+
+![n8n-nodes-openmrs](https://img.shields.io/npm/v/n8n-nodes-openmrs)
+![npm](https://img.shields.io/npm/dt/n8n-nodes-openmrs)
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+
+This is an n8n community node that provides seamless integration with OpenMRS through standardized FHIR R4 API endpoints. It enables healthcare workflows to access and process electronic medical records data for clinical decision support, data analysis, and interoperability.
+
+[n8n](https://n8n.io/) is a fair-code licensed workflow automation platform.
+
+## Features
+
+**Comprehensive FHIR R4 Support**
+
+- Access 6 core FHIR resources essential for clinical workflows
+- Standardized healthcare data format for maximum interoperability
+
+**Patient Data Management**
+
+- Fetch complete patient demographics and identifiers
+- Retrieve encounter history and visit timelines
+- Access clinical observations (labs, vitals, diagnostics)
+
+**Clinical Intelligence**
+
+- Diagnostic reports and imaging data
+- Condition/diagnosis tracking with staging
+- Medication statements and treatment history
+
+**Developer-Friendly**
+
+- Simple authentication with OpenMRS credentials
+- Paginated results with customizable limits
+- Built-in error handling and retry logic
+
+**Built for Low-Resource Settings**
+
+- Optimized for limited bandwidth environments
+- Works with standard OpenMRS installations
+- Supports both cloud and on-premise deployments
+
+## Installation
+
+### Community Nodes (Recommended)
+
+1. Open n8n
+2. Go to **Settings** → **Community Nodes**
+3. Click **Install a community node**
+4. Enter: `n8n-nodes-openmrs`
+5. Click **Install**
+
+### Manual Installation
+
+```bash
+npm install n8n-nodes-openmrs
+```
+
+For Docker installations:
+
+```bash
+docker run -it --rm \
+  --name n8n \
+  -p 5678:5678 \
+  -v ~/.n8n:/home/node/.n8n \
+  -e N8N_CUSTOM_EXTENSIONS="/home/node/.n8n/custom" \
+  n8nio/n8n
+```
+
+Then install the package inside the container or mount it as a volume.
+
+### Build from Source
+
+```bash
+git clone https://github.com/monfortbrian/n8n-nodes-OpenMRS.git
+cd n8n-nodes-openmrs
+npm install
+npm run build
+npm link
+```
+
+## Credentials
+
+Before using the OpenMRS node, you need to configure credentials:
+
+1. In n8n, go to **Credentials** → **New**
+2. Search for **OpenMRS API**
+3. Configure:
+   - **Base URL**: Your OpenMRS instance URL (e.g., `https://demo.openmrs.org/openmrs`)
+   - **Username**: Your OpenMRS username
+   - **Password**: Your OpenMRS password
+
+The node uses HTTP Basic Authentication and automatically validates connectivity on save.
+
+## Usage
+
+### Supported Resources
+
+The OpenMRS node provides access to 6 FHIR resources:
+
+| Resource                 | Description                   | Use Cases                                    |
+| ------------------------ | ----------------------------- | -------------------------------------------- |
+| **Patient**              | Demographics, identifiers     | Identity verification, cohort analysis       |
+| **Encounter**            | Visits, admissions            | Timeline reconstruction, visit patterns      |
+| **Observation**          | Labs, vitals, diagnostics     | Trend analysis, risk detection               |
+| **Diagnostic Report**    | Imaging, pathology            | Disease progression, treatment response      |
+| **Condition**            | Diagnoses, problem lists      | Differential diagnosis, comorbidity tracking |
+| **Medication Statement** | Active/historical medications | Treatment history, drug interactions         |
+
+### Operations
+
+Each resource supports:
+
+- **Get a resource** - Retrieve a single resource by ID
+- **Get all resources** - Retrieve all resources for a patient (with pagination)
+
+## Examples
+
+### Example 1: Fetch Patient Demographics
+
+```
+1. Add OpenMRS node
+2. Select Resource: Patient
+3. Select Operation: Get a resource
+4. Enter Patient ID: abc-123-def-456
+5. Execute
+```
+
+**Output:**
+
+```json
+{
+  "resourceType": "Patient",
+  "id": "abc-123-def-456",
+  "name": [
+    {
+      "given": ["John"],
+      "family": "Doe"
+    }
+  ],
+  "gender": "male",
+  "birthDate": "1957-03-15"
+}
+```
+
+### Example 2: Retrieve Patient Lab Results
+
+```
+1. Add OpenMRS node
+2. Select Resource: Observation
+3. Select Operation: Get all resources
+4. Enter Patient ID: abc-123-def-456
+5. Set Limit: 50
+6. Execute
+```
+
+**Output:** Returns up to 50 lab observations with values, units, and reference ranges.
+
+### Example 3: Get Patient Diagnosis History
+
+```
+1. Add OpenMRS node
+2. Select Resource: Condition
+3. Select Operation: Get all resources
+4. Enter Patient ID: abc-123-def-456
+5. Select Return All: true (for complete history)
+6. Execute
+```
+
+### Example 4: Clinical Decision Support Workflow
+
+Build an intelligent ASSESS workflow:
+
+```
+[OpenMRS Patient]    ──┐
+[OpenMRS Encounters]   ├─→ [Normalize Data] → [LLM Analysis] → [Alert Doctor]
+[OpenMRS Labs]    ─────┘
+```
+
+This workflow:
+
+1. Fetches patient demographics, encounters, and lab results
+2. Normalizes FHIR data into unified format
+3. Analyzes trends using AI
+4. Generates clinical insights
+
+## Options
+
+### Common Parameters
+
+| Parameter  | Type     | Description                  | Required                  |
+| ---------- | -------- | ---------------------------- | ------------------------- |
+| Resource   | Dropdown | FHIR resource type           | Yes                       |
+| Operation  | Dropdown | Get or Get All               | Yes                       |
+| Patient ID | String   | UUID of the patient          | Yes (for most operations) |
+| Return All | Boolean  | Fetch all results (no limit) | No                        |
+| Limit      | Number   | Max results (1-100)          | No (default: 50)          |
+
+### Resource-Specific Parameters
+
+**Encounter:**
+
+- Encounter ID (for Get operation)
+
+**Condition:**
+
+- Condition ID (for Get operation)
+
+**Medication Statement:**
+
+- Medication Statement ID (for Get operation)
+
+### Pagination
+
+For `Get all resources` operations:
+
+- Set **Return All** to `true` for complete datasets
+- Or set **Limit** to control result size (1-100)
+- Results are returned in FHIR Bundle format
+
+## API Endpoints
+
+This node uses OpenMRS FHIR2 R4 endpoints:
+
+```
+GET /ws/fhir2/R4/Patient/{id}
+GET /ws/fhir2/R4/Patient?_count=50
+
+GET /ws/fhir2/R4/Encounter?patient={id}&_count=50
+
+GET /ws/fhir2/R4/Observation?patient={id}&_count=50
+
+GET /ws/fhir2/R4/DiagnosticReport?patient={id}&_count=50
+
+GET /ws/fhir2/R4/Condition?patient={id}&_count=50
+
+GET /ws/fhir2/R4/MedicationStatement?patient={id}&_count=50
+```
+
+## Use Cases
+
+### Clinical Decision Support
+
+- Reconstruct patient timelines
+- Detect missed clinical signals
+- Flag abnormal lab trends
+- Track disease progression
+
+### Data Analytics
+
+- Population health analysis
+- Cohort identification
+- Treatment outcome tracking
+- Quality metrics reporting
+
+### Interoperability
+
+- Sync data between systems
+- Export for external analysis
+- Integration with AI/ML pipelines
+- REDCap or DHIS2 data flows
+
+### Global Health
+
+- Low-resource oncology workflows
+- HIV/TB treatment tracking
+- Maternal health monitoring
+- Vaccine registry management
+
+## Compatibility
+
+- **n8n version:** 0.187.0 or higher
+- **OpenMRS version:** 2.3+ with FHIR2 module installed
+- **Node.js:** 18.0.0 or higher
+
+## Development
+
+### Building
+
+```bash
+npm run build
+npm run dev
+```
+
+### Testing Locally
+
+```bash
+npm link
+cd ~/.n8n/custom
+npm link n8n-nodes-openmrs
+n8n start
+```
+
+## Troubleshooting
+
+### Node doesn't appear in n8n
+
+1. Verify package is installed: `npm list -g n8n-nodes-openmrs`
+2. Clear n8n cache: `rm -rf ~/.n8n/cache`
+3. Restart n8n
+4. Hard refresh browser (Ctrl+Shift+R)
+
+### Authentication errors
+
+- Verify Base URL includes `/openmrs` path (e.g., `https://demo.openmrs.org/openmrs`)
+- Confirm username/password are correct
+- Check OpenMRS FHIR2 module is installed and enabled
+
+### Empty results
+
+- Confirm patient UUID exists in your OpenMRS instance
+- Verify patient has data for the requested resource type
+- Check FHIR2 module configuration in OpenMRS
+
+## Resources
+
+- [OpenMRS Documentation](https://wiki.openmrs.org/)
+- [FHIR R4 Specification](https://hl7.org/fhir/R4/)
+- [n8n Community Nodes](https://docs.n8n.io/integrations/community-nodes/)
+- [OpenMRS FHIR2 Module](https://wiki.openmrs.org/display/projects/FHIR+Module)
+
+## Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+[MIT License](LICENSE)
+
+Copyright (c) 2026 Monfort N. Brian
+
+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.
+
+## Support
+
+- **Issues:** [GitHub Issues](https://github.com/monfortbrian/n8n-nodes-OpenMRS/issues)
+- **Discussions:** [GitHub Discussions](https://github.com/monfortbrian/n8n-nodes-OpenMRS/discussions)
+- **n8n Community:** [n8n Community Forum](https://community.n8n.io/)
+
+## Acknowledgments
+
+Built for healthcare workers in low-resource settings. Designed to enable clinical decision support and improve patient outcomes through better data interoperability.
+
+---
+
+**Made with ❤️ for the global health community**

package/dist/credentials/OpenMrsApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class OpenMrsApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/OpenMrsApi.credentials.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenMrsApi = void 0;
+class OpenMrsApi {
+    constructor() {
+        this.name = 'openMrsApi';
+        this.displayName = 'OpenMRS API';
+        this.documentationUrl = 'https://wiki.openmrs.org/display/docs/REST+API';
+        this.properties = [
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://your-openmrs-instance.org',
+                placeholder: 'https://demo.openmrs.org/openmrs',
+                description: 'The base URL of your OpenMRS instance',
+            },
+            {
+                displayName: 'Username',
+                name: 'username',
+                type: 'string',
+                default: '',
+                description: 'OpenMRS username',
+            },
+            {
+                displayName: 'Password',
+                name: 'password',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                description: 'OpenMRS password',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                auth: {
+                    username: '={{$credentials.username}}',
+                    password: '={{$credentials.password}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/ws/fhir2/R4/metadata',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.OpenMrsApi = OpenMrsApi;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './nodes/OpenMrs/OpenMrs.node';
+export * from './credentials/OpenMrsApi.credentials';

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./nodes/OpenMrs/OpenMrs.node"), exports);
+__exportStar(require("./credentials/OpenMrsApi.credentials"), exports);

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

@@ -0,0 +1,5 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class OpenMrs implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/OpenMrs/OpenMrs.node.js

@@ -0,0 +1,322 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenMrs = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+class OpenMrs {
+    constructor() {
+        this.description = {
+            displayName: 'OpenMRS',
+            name: 'openMrs',
+            icon: 'file:OpenMrs.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Interact with OpenMRS FHIR API',
+            defaults: {
+                name: 'OpenMRS',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'openMrsApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Patient',
+                            value: 'patient',
+                        },
+                        {
+                            name: 'Encounter',
+                            value: 'encounter',
+                        },
+                        {
+                            name: 'Observation',
+                            value: 'observation',
+                        },
+                        {
+                            name: 'Diagnostic Report',
+                            value: 'diagnosticReport',
+                        },
+                        {
+                            name: 'Condition',
+                            value: 'condition',
+                        },
+                        {
+                            name: 'Medication Statement',
+                            value: 'medicationStatement',
+                        },
+                    ],
+                    default: 'patient',
+                },
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: [
+                                'patient',
+                                'encounter',
+                                'observation',
+                                'diagnosticReport',
+                                'condition',
+                                'medicationStatement',
+                            ],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Get',
+                            value: 'get',
+                            description: 'Get a resource by ID',
+                            action: 'Get a resource',
+                        },
+                        {
+                            name: 'Get All',
+                            value: 'getAll',
+                            description: 'Get all resources',
+                            action: 'Get all resources',
+                        },
+                    ],
+                    default: 'get',
+                },
+                {
+                    displayName: 'Patient ID',
+                    name: 'patientId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['patient'],
+                            operation: ['get'],
+                        },
+                    },
+                    default: '',
+                    description: 'UUID of the patient',
+                },
+                {
+                    displayName: 'Patient ID',
+                    name: 'patientId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: [
+                                'encounter',
+                                'observation',
+                                'diagnosticReport',
+                                'condition',
+                                'medicationStatement',
+                            ],
+                            operation: ['getAll'],
+                        },
+                    },
+                    default: '',
+                    description: 'UUID of the patient to filter by',
+                },
+                {
+                    displayName: 'Encounter ID',
+                    name: 'encounterId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['encounter'],
+                            operation: ['get'],
+                        },
+                    },
+                    default: '',
+                    description: 'UUID of the encounter',
+                },
+                {
+                    displayName: 'Condition ID',
+                    name: 'conditionId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['condition'],
+                            operation: ['get'],
+                        },
+                    },
+                    default: '',
+                    description: 'UUID of the condition',
+                },
+                {
+                    displayName: 'Medication Statement ID',
+                    name: 'medicationStatementId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['medicationStatement'],
+                            operation: ['get'],
+                        },
+                    },
+                    default: '',
+                    description: 'UUID of the medication statement',
+                },
+                {
+                    displayName: 'Return All',
+                    name: 'returnAll',
+                    type: 'boolean',
+                    displayOptions: {
+                        show: {
+                            operation: ['getAll'],
+                        },
+                    },
+                    default: false,
+                    description: 'Whether to return all results or only up to a given limit',
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    displayOptions: {
+                        show: {
+                            operation: ['getAll'],
+                            returnAll: [false],
+                        },
+                    },
+                    typeOptions: {
+                        minValue: 1,
+                        maxValue: 100,
+                    },
+                    default: 50,
+                    description: 'Max number of results to return',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const credentials = await this.getCredentials('openMrsApi');
+        const baseUrl = credentials.baseUrl;
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const resource = this.getNodeParameter('resource', i);
+                const operation = this.getNodeParameter('operation', i);
+                let endpoint = '';
+                const qs = {};
+                if (resource === 'patient') {
+                    if (operation === 'get') {
+                        const patientId = this.getNodeParameter('patientId', i);
+                        endpoint = `/ws/fhir2/R4/Patient/${patientId}`;
+                    }
+                }
+                if (resource === 'encounter') {
+                    if (operation === 'get') {
+                        const encounterId = this.getNodeParameter('encounterId', i);
+                        endpoint = `/ws/fhir2/R4/Encounter/${encounterId}`;
+                    }
+                    else if (operation === 'getAll') {
+                        const patientId = this.getNodeParameter('patientId', i);
+                        endpoint = '/ws/fhir2/R4/Encounter';
+                        qs.patient = patientId;
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        if (!returnAll) {
+                            const limit = this.getNodeParameter('limit', i);
+                            qs._count = limit;
+                        }
+                    }
+                }
+                if (resource === 'observation') {
+                    if (operation === 'getAll') {
+                        const patientId = this.getNodeParameter('patientId', i);
+                        endpoint = '/ws/fhir2/R4/Observation';
+                        qs.patient = patientId;
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        if (!returnAll) {
+                            const limit = this.getNodeParameter('limit', i);
+                            qs._count = limit;
+                        }
+                    }
+                }
+                if (resource === 'diagnosticReport') {
+                    if (operation === 'getAll') {
+                        const patientId = this.getNodeParameter('patientId', i);
+                        endpoint = '/ws/fhir2/R4/DiagnosticReport';
+                        qs.patient = patientId;
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        if (!returnAll) {
+                            const limit = this.getNodeParameter('limit', i);
+                            qs._count = limit;
+                        }
+                    }
+                }
+                if (resource === 'condition') {
+                    if (operation === 'get') {
+                        const conditionId = this.getNodeParameter('conditionId', i);
+                        endpoint = `/ws/fhir2/R4/Condition/${conditionId}`;
+                    }
+                    else if (operation === 'getAll') {
+                        const patientId = this.getNodeParameter('patientId', i);
+                        endpoint = '/ws/fhir2/R4/Condition';
+                        qs.patient = patientId;
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        if (!returnAll) {
+                            const limit = this.getNodeParameter('limit', i);
+                            qs._count = limit;
+                        }
+                    }
+                }
+                if (resource === 'medicationStatement') {
+                    if (operation === 'get') {
+                        const medicationStatementId = this.getNodeParameter('medicationStatementId', i);
+                        endpoint = `/ws/fhir2/R4/MedicationStatement/${medicationStatementId}`;
+                    }
+                    else if (operation === 'getAll') {
+                        const patientId = this.getNodeParameter('patientId', i);
+                        endpoint = '/ws/fhir2/R4/MedicationStatement';
+                        qs.patient = patientId;
+                        const returnAll = this.getNodeParameter('returnAll', i);
+                        if (!returnAll) {
+                            const limit = this.getNodeParameter('limit', i);
+                            qs._count = limit;
+                        }
+                    }
+                }
+                const options = {
+                    method: 'GET',
+                    url: `${baseUrl}${endpoint}`,
+                    qs,
+                    json: true,
+                };
+                const responseData = await this.helpers.requestWithAuthentication.call(this, 'openMrsApi', options);
+                if (Array.isArray(responseData)) {
+                    returnData.push(...responseData.map((item) => ({ json: item })));
+                }
+                else if (responseData.entry) {
+                    // FHIR Bundle response
+                    returnData.push(...responseData.entry.map((entry) => ({
+                        json: entry.resource,
+                    })));
+                }
+                else {
+                    returnData.push({ json: responseData });
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                    returnData.push({ json: { error: errorMessage } });
+                    continue;
+                }
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        return [returnData];
+    }
+}
+exports.OpenMrs = OpenMrs;

package/dist/nodes/OpenMrs/OpenMrs.svg

@@ -0,0 +1,13 @@
+<svg width="128" height="128" viewBox="0 0 128 128" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_4731_3)">
+<path d="M34.8041 34.8877C42.2938 27.4204 52.6397 22.8017 64.0669 22.8017C75.4685 22.8017 85.7887 27.3995 93.2691 34.8318L93.2995 7.3477C84.5416 2.85009 74.5974 0.306641 64.0669 0.306641C53.5318 0.306641 43.5362 3.16918 34.7714 7.67146L34.8041 34.8877Z" fill="#F26522"/>
+<path d="M93.2995 93.21C85.8144 100.677 75.4708 105.294 64.0413 105.294C52.6467 105.294 42.3218 100.698 34.8368 93.2659L34.8041 120.748C43.5713 125.248 53.5062 127.789 64.0413 127.789C74.5764 127.789 84.5183 125.248 93.2785 120.745L93.2995 93.21Z" fill="#EEA616"/>
+<path d="M34.8625 93.2449C27.3751 85.7776 22.7416 75.4641 22.7416 64.0652C22.7416 52.6988 27.3517 42.4039 34.8041 34.9366L7.24605 34.9087C2.73634 43.6477 0.188393 53.5583 0.188393 64.0652C0.188393 74.5744 2.73634 84.4873 7.25072 93.2263L34.8625 93.2449Z" fill="#5B57A6"/>
+<path d="M93.2831 34.8296C100.773 42.2946 105.404 52.6151 105.404 64.014C105.404 75.3827 100.794 85.6752 93.3392 93.1356L120.9 93.1682C125.412 84.4315 127.957 74.5162 127.957 64.014C127.957 53.5048 125.412 43.5896 120.895 34.8482L93.2831 34.8296Z" fill="#009384"/>
+</g>
+<defs>
+<clipPath id="clip0_4731_3">
+<rect width="128" height="128" fill="white"/>
+</clipPath>
+</defs>
+</svg>

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "n8n-nodes-openmrs",
+  "version": "1.0.0",
+  "description": "n8n community node for seamless OpenMRS FHIR integration. Fetch patient demographics, encounters, observations, diagnostic reports, conditions, and medications through standardized FHIR R4 API endpoints.",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "n8n-node",
+    "openmrs",
+    "fhir",
+    "healthcare",
+    "ehr",
+    "emr",
+    "medical-records",
+    "clinical-data",
+    "health-informatics",
+    "interoperability",
+    "hl7-fhir",
+    "patient-data",
+    "oncology"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/monfortbrian/n8n-nodes-OpenMRS#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/monfortbrian/n8n-nodes-OpenMRS.git"
+  },
+  "bugs": {
+    "url": "https://github.com/monfortbrian/n8n-nodes-OpenMRS/issues"
+  },
+  "author": {
+    "name": "Monfort N. Brian",
+    "email": "monfortnkurunziza0@gmail.com"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc && npm run copy-assets",
+    "copy-assets": "node -e \"const fs=require('fs'); const path=require('path'); const src='src/nodes/OpenMrs/OpenMrs.svg'; const dest='dist/nodes/OpenMrs/OpenMrs.svg'; fs.mkdirSync(path.dirname(dest), {recursive:true}); fs.copyFileSync(src, dest); console.log('Icon copied successfully');\"",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "nodes": [
+      "dist/nodes/OpenMrs/OpenMrs.node.js"
+    ],
+    "credentials": [
+      "dist/credentials/OpenMrsApi.credentials.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "n8n-core": "^1.122.9",
+    "n8n-workflow": "^2.4.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}