n8n-nodes-qlik-cloud 1.0.0

package/.eslintrc.cjs

@@ -0,0 +1,18 @@
+module.exports = {
+  parser: '@typescript-eslint/parser',
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+  ],
+  env: {
+    node: true,
+    es2020: true,
+  },
+  parserOptions: {
+    ecmaVersion: 2020,
+    sourceType: 'module',
+  },
+  rules: {
+    '@typescript-eslint/no-explicit-any': 'warn',
+  },
+};

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 n8n-nodes-qlik-cloud 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,122 @@
+# n8n-nodes-qlik-cloud
+
+This package contains an n8n community node for integrating with **Qlik Cloud** REST APIs.
+
+## Features
+
+Complete integration with Qlik Cloud REST APIs covering:
+
+### Apps Management
+- **Get All Apps** - Retrieve all apps with filtering and pagination
+- **Get App** - Retrieve a specific app by ID
+- **Create App** - Create a new app
+- **Update App** - Update app properties
+- **Delete App** - Delete an app
+- **Copy App** - Create a copy of an app
+- **Export App** - Export app data
+- **Publish App** - Publish app to a space
+- **Get Privileges** - Retrieve app access privileges
+
+### Assistants
+- **Get All Assistants** - List all available assistants
+- **Get Assistant** - Retrieve a specific assistant by ID
+- **Create Assistant** - Create a new assistant
+- **Search** - Perform semantic search in assistant sources
+- **Delete Assistant** - Delete an assistant
+
+### Audits
+- **Get All Audits** - List recent audit events with filtering
+- **Get Audit** - Retrieve a specific audit event by ID
+- **Get Sources** - List possible audit event sources
+- **Get Types** - List possible audit event types
+- **Get Settings** - Retrieve audit server configuration
+
+### Items
+- **Get All Items** - List items accessible to the user
+- **Get Item** - Retrieve a specific item by ID
+- **Update Item** - Update item properties
+- **Delete Item** - Delete an item
+- **Collections** - List collections (tags) for an item
+- **Published Items** - List published copies of an item
+- **Settings** - Get or update items service settings
+
+## Authentication
+
+This node supports **Bearer Token Authentication**:
+
+1. **Get your Qlik Cloud tenant URL**
+   - Format: `https://{tenant}.{region}.qlikcloud.com`
+   - Example: `https://mycompany.us.qlikcloud.com`
+
+2. **Generate an API Key**
+   - Access your Qlik Cloud console
+   - Navigate to API Keys section
+   - Create a new API key with appropriate scopes
+   - Copy the generated token
+
+3. **Configure credentials in n8n**
+   - Create a new "Qlik Cloud API" credential
+   - Paste your tenant URL
+   - Paste your API key as the access token
+
+## Installation
+
+To install this node in your n8n instance:
+
+```bash
+npm install n8n-nodes-qlik-cloud
+```
+
+## Configuration
+
+### Node Configuration
+
+1. Add the **Qlik Cloud** node to your workflow
+2. Select the **Resource** (Apps, Assistants, Audits, or Items)
+3. Select the **Operation** you want to perform
+4. Configure any required parameters
+5. Set up your Qlik Cloud API credentials
+
+### Example: List All Apps
+
+1. Add a **Qlik Cloud** node
+2. Select Resource: **Apps**
+3. Select Operation: **Get All**
+4. Configure return settings (return all or limit)
+5. Set Qlik Cloud credentials
+6. Execute the workflow
+
+## API Documentation
+
+For detailed API documentation, visit:
+- [Qlik Cloud REST APIs](https://qlik.dev/apis/rest/)
+- [Apps API](https://qlik.dev/apis/rest/apps)
+- [Items API](https://qlik.dev/apis/rest/items)
+- [Audits API](https://qlik.dev/apis/rest/audits)
+- [Assistants API](https://qlik.dev/apis/rest/assistants)
+
+## Limitations
+
+- **Rate Limiting**: The Qlik Cloud API has rate limits per tier. Check documentation for your plan.
+- **Permissions**: Many operations require specific permissions in Qlik Cloud
+- **Binary Operations**: File upload/download operations return data references; handle file transfers separately
+- **Pagination**: Use `returnAll` option to retrieve all results or `limit` for pagination
+
+## Support
+
+For issues or feature requests:
+- GitHub Issues: [n8n-nodes-qlik-cloud](https://github.com/yourusername/n8n-nodes-qlik-cloud/issues)
+- n8n Community: [n8n Community Forum](https://community.n8n.io)
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please fork this repository and submit pull requests.
+
+## Changelog
+
+### Version 1.0.0
+- Initial release with support for Apps, Items, Audits, and Assistants APIs

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "n8n-nodes-qlik-cloud",
+  "version": "1.0.0",
+  "description": "n8n node for Qlik Cloud REST APIs integration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src/",
+    "test": "jest"
+  },
+  "n8n": {
+    "nodes": [
+      "dist/nodes/QlikCloud/QlikCloud.node.js"
+    ],
+    "credentials": [
+      "dist/credentials/QlikCloudApi.credentials.js",
+      "dist/credentials/QlikCloudOAuth2Api.credentials.js"
+    ]
+  },
+  "keywords": [
+    "n8n",
+    "qlik",
+    "qlik-cloud",
+    "api",
+    "automation"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^18.0.0",
+    "@typescript-eslint/eslint-plugin": "^5.0.0",
+    "@typescript-eslint/parser": "^5.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.0.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "n8n-core": "*",
+    "n8n-workflow": "*",
+    "axios": "^1.4.0"
+  }
+}

package/src/credentials/QlikCloudApi.credentials.ts

@@ -0,0 +1,33 @@
+import type {
+	ICredentialType,
+	INodeProperties,
+} from 'n8n-workflow';
+
+export class QlikCloudApi implements ICredentialType {
+	name = 'qlikCloudApi';
+	displayName = 'Qlik Cloud API';
+	documentationUrl = 'https://qlik.dev/apis/rest/';
+
+	properties: INodeProperties[] = [
+		{
+			displayName: 'Tenant URL',
+			name: 'baseUrl',
+			type: 'string',
+			default: '',
+			required: true,
+			placeholder: 'https://{tenant}.{region}.qlikcloud.com',
+			description: 'The base URL of your Qlik Cloud tenant',
+		},
+		{
+			displayName: 'API Key (Access Token)',
+			name: 'accessToken',
+			type: 'string',
+			typeOptions: {
+				password: true,
+			},
+			default: '',
+			required: true,
+			description: 'Bearer token for API authentication. Generate from Qlik Cloud console',
+		},
+	];
+}

package/src/credentials/QlikCloudOAuth2Api.credentials.ts

@@ -0,0 +1,80 @@
+import type {
+	ICredentialType,
+	INodeProperties,
+} from 'n8n-workflow';
+
+const scopes = [
+	'https://analysis.windows.net/powerbi/api/.default',
+];
+
+export class QlikCloudOAuth2Api implements ICredentialType {
+	name = 'qlikCloudOAuth2Api';
+	displayName = 'Qlik Cloud OAuth2 API';
+	documentationUrl = 'https://qlik.dev/authenticate/';
+	extends = ['oAuth2Api'];
+
+	properties: INodeProperties[] = [
+		{
+			displayName: 'Tenant URL',
+			name: 'baseUrl',
+			type: 'string',
+			default: '',
+			required: true,
+			placeholder: 'https://{tenant}.{region}.qlikcloud.com',
+			description: 'The base URL of your Qlik Cloud tenant',
+		},
+		{
+			displayName: 'Authorization URL',
+			name: 'authUrl',
+			type: 'hidden',
+			default: '',
+			required: true,
+		},
+		{
+			displayName: 'Access Token URL',
+			name: 'accessTokenUrl',
+			type: 'hidden',
+			default: '',
+			required: true,
+		},
+		{
+			displayName: 'Scope',
+			name: 'scope',
+			type: 'hidden',
+			default: scopes.join(' '),
+			description: 'OAuth2 scopes required for Qlik Cloud API access',
+		},
+		{
+			displayName: 'Authentication',
+			name: 'authentication',
+			type: 'hidden',
+			default: 'body',
+		},
+	];
+
+	async preAuthentication(this: any, credentials: any) {
+		const baseUrl = credentials.baseUrl as string;
+		
+		// Extract tenant and region from base URL
+		// Expected format: https://tenant.region.qlikcloud.com
+		const urlParts = new URL(baseUrl);
+		const hostname = urlParts.hostname;
+		const parts = hostname.split('.');
+		
+		if (parts.length < 3) {
+			throw new Error('Invalid Qlik Cloud tenant URL format');
+		}
+
+		const tenant = parts[0];
+		const region = parts[1];
+
+		// Construct OAuth endpoints
+		const authEndpoint = `https://auth.${region}.qlikcloud.com/oauth/authorize`;
+		const tokenEndpoint = `https://auth.${region}.qlikcloud.com/oauth/token`;
+
+		credentials.authUrl = authEndpoint;
+		credentials.accessTokenUrl = tokenEndpoint;
+		
+		return credentials;
+	}
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { QlikCloud } from './QlikCloud.node';