@orchesty/connector-wflow 1.0.5 → 2.0.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @orchesty/connector-wflow
 
+## 2.0.1
+
+### Patch Changes
+
+- Updated release
+
+## 2.0.0
+
+### Major Changes
+
+- Use @orchesty/nodejs-sdk ^5.0
+
 ## 1.0.5
 
 ### Patch Changes

package/README.md

@@ -0,0 +1,102 @@
+# Wflow Connector
+
+[![npm](https://img.shields.io/npm/v/@orchesty/connector-wflow?color=15ba68)](https://www.npmjs.com/package/@orchesty/connector-wflow)
+[![License](https://img.shields.io/badge/license-Apache--2.0-15ba68)](https://github.com/Orchesty/orchesty-nodejs-connectors/blob/master/LICENSE)
+
+An [Orchesty](https://orchesty.io) connector for wflow, a digital accounting platform that automates document processing, extraction, and approval workflows.
+
+## Application Type
+
+**OAuth 2.0**
+
+This connector uses the wflow OAuth 2.0 authorization flow via `https://account.wflow.com/connect/authorize`. After authorization, the selected organization is stored in a separate settings form that is populated dynamically.
+
+> **Note:** `WflowApplication` requires `OAuth2Provider` and `WflowGetOrganizationsConnector` in its constructor.
+
+| Field | Description |
+|---|---|
+| `client_id` | Your wflow app Client ID |
+| `client_secret` | Your wflow app Client Secret |
+| `organization` | Selected wflow organization ID (populated after authorization) |
+
+## Components
+
+| Class | Type | Description |
+|---|---|---|
+| `WflowGetDocumentConnector` | Connector | Retrieves a document by ID via `GET /{org}/documents/{documentId}` |
+| `WflowGetDocumentMainFileConnector` | Connector | Downloads the main file of a document as base64 via `GET /{org}/documents/{documentId}/files/main/download` |
+| `WflowGetDocumentTypesConnector` | Connector | Lists available document types via `GET /{org}/documents/types` |
+| `WflowGetOrganizationsConnector` | Connector | Lists accessible organizations via `GET /user/myorganizations` |
+| `WflowPatchAccountingRulesConnector` | Connector | Updates accounting rules register entries via `PATCH /{org}/registers/accountingrules` |
+| `WflowPatchChartOfAccountsConnector` | Connector | Updates chart of accounts register entries via `PATCH /{org}/registers/chartofaccounts` |
+| `WflowPatchContractsConnector` | Connector | Updates contracts register entries via `PATCH /{org}/registers/contracts` |
+| `WflowPatchCostCentersConnector` | Connector | Updates cost centers register entries via `PATCH /{org}/registers/costcenters` |
+| `WflowPatchSeriesConnector` | Connector | Updates series register entries via `PATCH /{org}/registers/series` |
+| `WflowPatchVatControlStatementLinesConnector` | Connector | Updates VAT control statement lines via `PATCH /{org}/registers/vatcontrolstatementlines` |
+| `WflowPatchVatReturnLinesConnector` | Connector | Updates VAT return lines via `PATCH /{org}/registers/vatreturnlines` |
+| `WflowPutDocumentConnector` | Connector | Creates or replaces a document via `PUT /{org}/documents` |
+| `WflowUpdateDocumentStateConnector` | Connector | Marks a document export task as processed via `PUT /{org}/documents/{documentId}/task/Export/processed` |
+| `WflowSubscribeWebhookBatch` | Batch | Registers webhook subscriptions via `PUT /{org}/webhookregistrations` |
+| `WflowUnsubscribeWebhookBatch` | Batch | Removes registered webhook subscriptions via `DELETE /{org}/webhookregistrations/{webhookId}` |
+
+## Setup
+
+### Credentials
+
+1. Contact [wflow](https://www.wflow.com/) to obtain API client credentials for your organization.
+2. In Orchesty, open the wflow application settings, enter the **Client ID** and **Client Secret**, and complete the OAuth authorization flow.
+3. After authorization, select your **organization** from the dropdown (populated automatically from your wflow account).
+
+### API Documentation
+
+wflow API: [https://www.wflow.com/](https://www.wflow.com/)
+
+## Installation & Usage
+
+Install the package:
+
+```bash
+npm install @orchesty/connector-wflow @orchesty/nodejs-sdk
+# or
+pnpm add @orchesty/connector-wflow @orchesty/nodejs-sdk
+```
+
+Register the application and nodes in your Orchesty DI container:
+
+```typescript
+import { container } from '@orchesty/nodejs-sdk';
+import { OAuth2Provider } from '@orchesty/nodejs-sdk/dist/lib/Authorization/Provider/OAuth2/OAuth2Provider';
+import WflowApplication from '@orchesty/connector-wflow/dist/WflowApplication';
+import WflowGetOrganizationsConnector from '@orchesty/connector-wflow/dist/Connector/WflowGetOrganizationsConnector';
+import WflowGetDocumentConnector from '@orchesty/connector-wflow/dist/Connector/WflowGetDocumentConnector';
+import WflowPutDocumentConnector from '@orchesty/connector-wflow/dist/Connector/WflowPutDocumentConnector';
+import WflowUpdateDocumentStateConnector from '@orchesty/connector-wflow/dist/Connector/WflowUpdateDocumentStateConnector';
+import WflowSubscribeWebhookBatch from '@orchesty/connector-wflow/dist/Batch/WflowSubscribeWebhookBatch';
+import WflowUnsubscribeWebhookBatch from '@orchesty/connector-wflow/dist/Batch/WflowUnsubscribeWebhookBatch';
+
+const getOrgsConnector = new WflowGetOrganizationsConnector();
+const app = new WflowApplication(container.get(OAuth2Provider), getOrgsConnector);
+container.setApplication(app);
+container.setNode(getOrgsConnector, app);
+container.setNode(new WflowGetDocumentConnector(), app);
+container.setNode(new WflowPutDocumentConnector(), app);
+container.setNode(new WflowUpdateDocumentStateConnector(), app);
+container.setNode(new WflowSubscribeWebhookBatch(), app);
+container.setNode(new WflowUnsubscribeWebhookBatch(), app);
+// ... register remaining connectors similarly
+```
+
+## License
+
+This connector is released under the **Apache License 2.0**. See the [LICENSE](https://github.com/Orchesty/orchesty-nodejs-connectors/blob/master/LICENSE) file for the full license text.
+
+## Contributing
+
+Contributions are welcome! This connector is part of the open-source [Orchesty Node.js Connectors](https://github.com/Orchesty/orchesty-nodejs-connectors) monorepo.
+
+For guidelines on how to create or update connectors — including project setup, coding conventions, and how to write tests — please refer to the **[Contributing to Connectors](https://orchesty.io/community/contributing-to-connectors)** guide.
+
+All contributions should include:
+- Source code in `src/` following the existing connector structure
+- Tests in `src/**/__tests__/` with `input.json`, `mock.json`, and `output.json` fixtures
+- An updated `CHANGELOG.md` entry

package/package.json

@@ -1,14 +1,18 @@
 {
   "name": "@orchesty/connector-wflow",
   "description": "",
-  "version": "1.0.5",
+  "version": "2.0.1",
   "license": "Apache-2.0",
   "url": "https://github.com/Orchesty/orchesty-nodejs-connectors",
-  "repository": "https://github.com/Orchesty/orchesty-nodejs-connectors",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Orchesty/orchesty-nodejs-connectors"
+  },
   "keywords": [],
   "author": "info@hanaboso.com",
   "dependencies": {
-    "@orchesty/nodejs-sdk": "^4.3.6"
+    "@orchesty/nodejs-sdk": "^5.0.13",
+    "http-status-codes": "^2.3.0"
   },
   "engines": {
     "node": ">=24"

package/src/Batch/WflowSubscribeWebhookBatch.ts

@@ -25,6 +25,7 @@ export default class WflowSubscribeWebhookBatch extends ABatchNode {
         const registeredEvents = (await repository.findMany({
             users: [appInstall.getUser()],
             apps: [appInstall.getName()],
+            sdks: [appInstall.getSdk()],
         })).map((webhook) => webhook.getName());
 
         const unsubscribed = subscriptions.find(
@@ -69,6 +70,7 @@ export default class WflowSubscribeWebhookBatch extends ABatchNode {
             new Webhook()
                 .setWebhookId(id)
                 .setUser(appInstall.getUser())
+                .setSdk(appInstall.getSdk())
                 .setNode(unsubscribed.getNode())
                 .setToken(token)
                 .setApplication(appInstall.getName())

package/src/Batch/WflowUnsubscribeWebhookBatch.ts

@@ -4,6 +4,7 @@ import ABatchNode from '@orchesty/nodejs-sdk/dist/lib/Batch/ABatchNode';
 import OnRepeatException from '@orchesty/nodejs-sdk/dist/lib/Exception/OnRepeatException';
 import { HttpMethods } from '@orchesty/nodejs-sdk/dist/lib/Transport/HttpMethods';
 import BatchProcessDto from '@orchesty/nodejs-sdk/dist/lib/Utils/BatchProcessDto';
+import { StatusCodes } from 'http-status-codes';
 import WflowApplication, { NAME as WFLOW_APP_NAME } from '../WflowApplication';
 
 export const NAME = `${WFLOW_APP_NAME}-unsubscribe-webhooks-batch`;
@@ -22,6 +23,7 @@ export default class WflowUnsubscribeWebhookBatch extends ABatchNode {
         const webhook = await repository.findOne({
             users: [appInstall.getUser()],
             apps: [appInstall.getName()],
+            sdks: [appInstall.getSdk()],
         });
 
         if (!webhook) {
@@ -45,7 +47,7 @@ export default class WflowUnsubscribeWebhookBatch extends ABatchNode {
 
         const response = await this.getSender().send(request);
 
-        if (response.getResponseCode() as number !== 200) {
+        if (response.getResponseCode() !== StatusCodes.OK) {
             await repository.update(webhook.setUnsubscribeFailed(true));
             throw new OnRepeatException(300, 12, response.getBody());
         }

package/src/Batch/__tests__/Data/WflowSubscribeWebhookBatch/input.json

@@ -1,6 +1,7 @@
 {
     "headers": {
-        "user": "TestUser"
+        "user": "TestUser",
+        "sdk": "TestSdk"
     },
     "data": {}
 }

package/src/Batch/__tests__/Data/WflowSubscribeWebhookBatch/output.json

@@ -1,6 +1,7 @@
 {
     "headers": {
-        "user": "TestUser"
+        "user": "TestUser",
+        "sdk": "TestSdk"
     },
     "data": []
-}
+}

package/src/Batch/__tests__/Data/WflowUnsubscribeWebhookBatch/input.json

@@ -1,6 +1,7 @@
 {
     "headers": {
-        "user": "TestUser"
+        "user": "TestUser",
+        "sdk": "TestSdk"
     },
     "data": {}
-}
+}

package/src/Batch/__tests__/Data/WflowUnsubscribeWebhookBatch/output.json

@@ -1,6 +1,7 @@
 {
     "headers": {
-        "user": "TestUser"
+        "user": "TestUser",
+        "sdk": "TestSdk"
     },
     "data": []
-}
+}

package/src/Connector/__tests__/Data/WflowGetDocumentConnector/input.json

@@ -1,9 +1,10 @@
 {
-  "headers": {
-    "user": "TestUser"
-  },
-  "data": {
-      "organization": "test",
-      "documentId": "463b5265-2672-4191-9e3b-9d6fcfe6a452"
-  }
+    "headers": {
+        "user": "TestUser",
+        "sdk": "TestSdk"
+    },
+    "data": {
+        "organization": "test",
+        "documentId": "463b5265-2672-4191-9e3b-9d6fcfe6a452"
+    }
 }