From eb0435ac3d93448f0b39df8f5ac16435017ead47 Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Wed, 3 Jun 2026 10:54:09 +0200 Subject: [PATCH 01/16] 5137 docs - generate component - update path after reorganization --- .../docs/developer-guide/generate-component/initial-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/docs/developer-guide/generate-component/initial-setup.mdx b/docs/content/docs/developer-guide/generate-component/initial-setup.mdx index 169b0b27038..b8f03dc98d8 100644 --- a/docs/content/docs/developer-guide/generate-component/initial-setup.mdx +++ b/docs/content/docs/developer-guide/generate-component/initial-setup.mdx @@ -7,7 +7,7 @@ title: "Initial Setup" This section provides a clear step-by-step guide for setting up a new component in your project, ensuring it is properly integrated into the build system and recognized by the IDE. 1. Create a New Package: - - Navigate to `server/apps/libs/modules/components/`. + - Navigate to `server/libs/modules/components/`. - Create a new package with the name of your component, e.g., `newcomponent`. 2. Update Settings: From 960aa36aded2cd0aac948f0df4a68d0ef7ccfcd8 Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Wed, 3 Jun 2026 10:59:15 +0200 Subject: [PATCH 02/16] 5137 settings - include new component into build --- settings.gradle.kts | 3 +++ 1 file changed, 3 insertions(+) diff --git a/settings.gradle.kts b/settings.gradle.kts index 3c8ba1a7fec..56fbe65f400 100644 --- a/settings.gradle.kts +++ b/settings.gradle.kts @@ -350,6 +350,7 @@ include("server:libs:modules:components:form") include("server:libs:modules:components:ftp") include("server:libs:modules:components:freshdesk") include("server:libs:modules:components:freshsales") +include("server:libs:modules:components:gaurus") include("server:libs:modules:components:github") include("server:libs:modules:components:gitlab") include("server:libs:modules:components:google:google-bigquery") @@ -673,3 +674,5 @@ include("server:ee:libs:platform:platform-workflow:platform-workflow-worker:plat include("server:ee:libs:modules:components:api-platform") include("server:ee:libs:modules:components:app-event") include("server:ee:libs:modules:components:code-workflow") + +include("server:libs:modules:components:gaurus") From 1e1414de4c77e49699c59e8b367f03824eeb6628 Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Wed, 3 Jun 2026 10:59:35 +0200 Subject: [PATCH 03/16] 5137 settings - sort --- settings.gradle.kts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/settings.gradle.kts b/settings.gradle.kts index 56fbe65f400..e77b0569171 100644 --- a/settings.gradle.kts +++ b/settings.gradle.kts @@ -347,9 +347,9 @@ include("server:libs:modules:components:file-storage") include("server:libs:modules:components:filesystem") include("server:libs:modules:components:firecrawl") include("server:libs:modules:components:form") -include("server:libs:modules:components:ftp") include("server:libs:modules:components:freshdesk") include("server:libs:modules:components:freshsales") +include("server:libs:modules:components:ftp") include("server:libs:modules:components:gaurus") include("server:libs:modules:components:github") include("server:libs:modules:components:gitlab") From 8ea1fdc3b1911b4042d2504df97be50c176eb94b Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Wed, 3 Jun 2026 14:34:23 +0200 Subject: [PATCH 04/16] 5137 cli - commands - generate component - support $ref reference for parameters, support example arrays --- .../ComponentInitOpenApiGenerator.java | 82 ++++++++++++++----- 1 file changed, 60 insertions(+), 22 deletions(-) diff --git a/cli/commands/component/init/openapi/src/main/java/com/bytechef/cli/command/component/init/openapi/ComponentInitOpenApiGenerator.java b/cli/commands/component/init/openapi/src/main/java/com/bytechef/cli/command/component/init/openapi/ComponentInitOpenApiGenerator.java index 2699be5642a..773648ce1af 100644 --- a/cli/commands/component/init/openapi/src/main/java/com/bytechef/cli/command/component/init/openapi/ComponentInitOpenApiGenerator.java +++ b/cli/commands/component/init/openapi/src/main/java/com/bytechef/cli/command/component/init/openapi/ComponentInitOpenApiGenerator.java @@ -26,6 +26,7 @@ import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.SerializationFeature; +import com.fasterxml.jackson.databind.node.ArrayNode; import com.fasterxml.jackson.databind.node.ObjectNode; import com.fasterxml.jackson.datatype.jdk8.Jdk8Module; import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule; @@ -394,6 +395,15 @@ private void checkAdditionalProperties( if (schema.getExample() != null) { if (Objects.equals(type, "string")) { builder.add(".exampleValue($S)", schema.getExample()); + } else if (Objects.equals(type, "array")) { + ArrayNode exampleArrayNode = (ArrayNode) schema.getExample(); + Object[] exampleArray = new Object[exampleArrayNode.size()]; + + for (int i = 0; i < exampleArray.length; i++) { + exampleArray[i] = exampleArrayNode.get(i); + } + + builder.add(".exampleValue($L)", exampleArray); } else { builder.add(".exampleValue($L)", schema.getExample()); } @@ -1606,30 +1616,28 @@ private String getPackageName() { private CodeBlock getParametersPropertiesCodeBlock(Operation operation, OpenAPI openAPI) { List codeBlocks = new ArrayList<>(); - List parameters = operation.getParameters(); + List parameters = resolveParameters(operation.getParameters(), openAPI); - if (parameters != null) { - for (Parameter parameter : parameters) { - CodeBlock.Builder builder = CodeBlock.builder(); + for (Parameter parameter : parameters) { + CodeBlock.Builder builder = CodeBlock.builder(); - builder.add( - getSchemaCodeBlock( - parameter.getName(), parameter.getDescription(), parameter.getRequired(), null, - parameter.getSchema(), false, false, openAPI, false)); - builder.add( - CodeBlock.of( - """ - .metadata( - $T.of( - "type", PropertyType.$L - ) - ) - """, - Map.class, - StringUtils.upperCase(parameter.getIn()))); - - codeBlocks.add(builder.build()); - } + builder.add( + getSchemaCodeBlock( + parameter.getName(), parameter.getDescription(), parameter.getRequired(), null, + parameter.getSchema(), false, false, openAPI, false)); + builder.add( + CodeBlock.of( + """ + .metadata( + $T.of( + "type", PropertyType.$L + ) + ) + """, + Map.class, + StringUtils.upperCase(parameter.getIn()))); + + codeBlocks.add(builder.build()); } return codeBlocks.stream() @@ -1736,6 +1744,36 @@ private CodeBlock getRefCodeBlock( outputSchema, openAPI, bodySchema); } + private List resolveParameters(List parameters, OpenAPI openAPI) { + List resolvedParameters = new ArrayList<>(); + + parameters.forEach(explicitParameter -> { + if (explicitParameter.get$ref() == null) { + resolvedParameters.add(explicitParameter); + + return; + } + + String parameterReference = explicitParameter.get$ref(); + + if (parameterReference.startsWith("#/components/parameters/")) { + parameterReference = parameterReference.substring("#/components/paramaters/".length()); + } + + Components components = openAPI.getComponents(); + + Map parameterDefinitions = components.getParameters(); + + if (!parameterDefinitions.containsKey(parameterReference)) { + throw new IllegalArgumentException("Missing parameter definition for " + explicitParameter.get$ref()); + } + + resolvedParameters.add(parameterDefinitions.get(parameterReference)); + }); + + return resolvedParameters; + } + @SuppressWarnings({ "rawtypes" }) From 903385bdb3a77206a555a7e49ae76e9dc421ffec Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Wed, 3 Jun 2026 14:39:06 +0200 Subject: [PATCH 05/16] 5137 components - gaurus - new module with openapi specification --- .../modules/components/gaurus/build.gradle | 1 + .../components/gaurus/gaurusOpenApi.yaml | 540 ++++++++++++++++++ 2 files changed, 541 insertions(+) create mode 100644 server/libs/modules/components/gaurus/build.gradle create mode 100644 server/libs/modules/components/gaurus/gaurusOpenApi.yaml diff --git a/server/libs/modules/components/gaurus/build.gradle b/server/libs/modules/components/gaurus/build.gradle new file mode 100644 index 00000000000..190b578b89f --- /dev/null +++ b/server/libs/modules/components/gaurus/build.gradle @@ -0,0 +1 @@ +version="1.0" diff --git a/server/libs/modules/components/gaurus/gaurusOpenApi.yaml b/server/libs/modules/components/gaurus/gaurusOpenApi.yaml new file mode 100644 index 00000000000..782b5b5a1b1 --- /dev/null +++ b/server/libs/modules/components/gaurus/gaurusOpenApi.yaml @@ -0,0 +1,540 @@ +openapi: "3.0.0" +info: + title: "Bank Connect" + version: "1.0.0" + description: "Bank Connect API specification" + contact: + email: "psd2@gaurus.hr" +servers: + - url: https://bankconnect.gaurus.hr/api/client +paths: + /accounts: + get: + tags: + - "Accounts" + operationId: getAccounts + summary: "Gets accounts for provided client id." + parameters: + - $ref: "#/components/parameters/ClientId" + - $ref: "#/components/parameters/RequestId" + - $ref: "#/components/parameters/Timestamp" + - $ref: "#/components/parameters/Signature" + responses: + "200": + description: "Success." + content: + application/json: + schema: + $ref: "#/components/schemas/MyResponse" + example: + code: "OK" + message: "" + hasMoreResults: false + data: "AccountResult[]" + "500": + $ref: "#/components/responses/InternalServerError" + /accounts/{iban}/transactions: + get: + tags: + - "Accounts" + operationId: getAccountTransactions + summary: "Gets transactions for provided IBAN and query parameters." + description: "General rules for query parameters: +
    +
  • If lastTransactionid is provided without date parameters system will not set default values for date range (only lastTransactionId will be used for data filtering).
    • +
  • Max range between dateFrom and dateTo is 7 days. If provided date range is greater, dateFrom is set to the dateTo minus 7 days.
    • +
  • If dateFrom and dateTo are not provided: +
      +
    • dateFrom is set to the current date minus 7 days
      • +
    • dateTo is set to the current date
      • +
    +
    • +
  • If dateFrom is provided and dateTo is not provided: +
      +
    1. If dateFrom is set to future date, it is set to the current date.
      2. +
    2. dateTo is set to dateFrom plus 1 day
      3. +
    +
    • +
  • If dateFrom is not provided and dateTo is provided: +
      +
    1. If dateTo is set to future date, it is set to the current date.
      2. +
    2. dateFrom is set to dateTo minus 1 day
      3. +
    +
    • +
" + parameters: + - $ref: "#/components/parameters/ClientId" + - $ref: "#/components/parameters/RequestId" + - $ref: "#/components/parameters/Timestamp" + - $ref: "#/components/parameters/Signature" + - in: path + name: iban + description: "Account IBAN." + required: true + schema: + type: string + example: "HR1210010051863000160" + - in: query + name: dateFrom + description: "Oldest transaction execution date." + required: false + schema: + type: string + example: "2021-01-01" + - in: query + name: dateTo + description: "Newest transaction execution date." + required: false + schema: + type: string + example: "2021-01-01" + - in: query + name: lastTransactionId + description: "If this parameter is specified, system will return transactions stored after the corresponding transaction." + required: false + schema: + type: integer + example: 123 + responses: + "200": + description: "Success." + content: + application/json: + schema: + $ref: "#/components/schemas/MyResponse" + example: + code: "OK" + message: "" + hasMoreResults: true + data: "TransactionResult[]" + "400": + description: "Validation failed." + content: + application/json: + schema: + $ref: "#/components/schemas/MyResponse" + example: + code: "VALIDATION_FAILED" + message: "Iban valid: false" + hasMoreResults: false + data: "[]" + "500": + $ref: "#/components/responses/InternalServerError" + /external-users: + get: + tags: + - "External Users" + operationId: getExternalUsers + summary: "Gets external users for provided client id." + parameters: + - $ref: "#/components/parameters/ClientId" + - $ref: "#/components/parameters/RequestId" + - $ref: "#/components/parameters/Timestamp" + - $ref: "#/components/parameters/Signature" + responses: + "200": + description: "Success." + content: + application/json: + schema: + $ref: "#/components/schemas/ServiceResponse" + example: + data: + - id: 42 + name: "Pero Perić d.o.o." + oib: "12345678901" + mail: "pero@example.com" + bankEntries: + - bankSlug: "erste" + ibans: ["HR1210010051863000160"] + consentJobStatus: "PENDING" + errors: [] + "500": + $ref: "#/components/responses/InternalServerError" + post: + tags: + - "External Users" + operationId: postExternalUsers + summary: "Creates external users with bank consent jobs." + parameters: + - $ref: "#/components/parameters/ClientId" + - $ref: "#/components/parameters/RequestId" + - $ref: "#/components/parameters/Timestamp" + - $ref: "#/components/parameters/Signature" + requestBody: + required: true + content: + application/json: + schema: + type: "array" + items: + $ref: "#/components/schemas/ExternalUserRequest" + example: + - name: "Pero Perić d.o.o." + oib: "12345678901" + mail: "pero@example.com" + bankEntries: + - bankSlug: "erste" + ibans: ["HR1210010051863000160"] + psuIdType: "HRIdentificationNumber" + responses: + "200": + description: "Success." + content: + application/json: + schema: + $ref: "#/components/schemas/ServiceResponse" + example: + data: + - existingMails: ["existing@example.com"] + newMails: ["new@example.com"] + errors: [] + "500": + $ref: "#/components/responses/InternalServerError" + /external-users/{externalUserId}: + put: + tags: + - "External Users" + operationId: putExternalUser + summary: "Updates an external user." + parameters: + - $ref: "#/components/parameters/ClientId" + - $ref: "#/components/parameters/RequestId" + - $ref: "#/components/parameters/Timestamp" + - $ref: "#/components/parameters/Signature" + - in: path + name: externalUserId + description: "External user identifier." + required: true + schema: + type: integer + format: int64 + example: 42 + responses: + "200": + description: "Success." + "500": + $ref: "#/components/responses/InternalServerError" + delete: + tags: + - "External Users" + operationId: deleteExternalUser + summary: "Deletes an external user." + parameters: + - $ref: "#/components/parameters/ClientId" + - $ref: "#/components/parameters/RequestId" + - $ref: "#/components/parameters/Timestamp" + - $ref: "#/components/parameters/Signature" + - in: path + name: externalUserId + description: "External user identifier." + required: true + schema: + type: integer + format: int64 + example: 42 + responses: + "204": + description: "External user deleted successfully." + "500": + $ref: "#/components/responses/InternalServerError" +components: + parameters: + ClientId: + in: header + name: clientId + description: "Client identifier provided by the system." + required: true + schema: + type: string + format: uuid + example: "4181a492-97bf-48ee-b29e-d7d6860c5565" + RequestId: + in: header + name: requestId + description: "Unique identifier of a request (must be generated by client)." + required: true + schema: + type: string + format: uuid + example: "17fcaa13-eb6d-467c-a757-2e669179a19e" + Timestamp: + in: header + name: timestamp + description: "Current timestamp in UTC format (must be generated by client)." + required: true + schema: + type: string + format: date-time + example: "2021-01-01T11:38:20.791Z" + Signature: + in: header + name: signature + description: " +

Request signature calculated by client. Algorithm for signing is as follows:

+
    +
  1. + Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body} +
      +
    • + Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included! +
      • +
    • + If request body is not present, use empty string for {body} value. +
      • +
    +
    2. +
  2. Using client secret sign the payload with HmacSHA256 algorithm.
    3. +
  3. Encode resulting signature in base64.
    4. +
" + required: true + schema: + type: string + example: "ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=" + schemas: + ServiceResponse: + type: "object" + description: "Standard response wrapper for all API endpoints." + properties: + data: + type: "array" + items: + oneOf: + - $ref: "#/components/schemas/ExternalUserResult" + - $ref: "#/components/schemas/CreateExternalUsersResponse" + description: "List of results (empty if the response is not valid)." + errors: + type: "array" + items: + $ref: "#/components/schemas/ErrorData" + description: "List of errors (empty if the response is valid)." + ErrorData: + type: "object" + properties: + code: + type: "string" + description: "Error code." + example: "GENERAL_ERROR" + description: + type: "string" + description: "Error description." + example: "General error" + AccountResult: + type: "object" + properties: + companyName: + type: "string" + description: "Account owner. This field is NOT present for the REGULAR users." + example: "Gaurus d.o.o." + iban: + type: "string" + description: "Account IBAN." + example: "HR1210010051863000160" + accountName: + type: "string" + description: "Account name." + example: "Tekući račun" + bankName: + type: "string" + description: "Bank name." + example: "Erste bank" + ExternalUserResult: + type: "object" + properties: + id: + type: "integer" + format: "int64" + description: "External user identifier." + example: 42 + name: + type: "string" + description: "External user company name." + example: "Pero Perić d.o.o." + oib: + type: "string" + description: "External user OIB (Croatian personal identification number)." + example: "12345678901" + mail: + type: "string" + description: "External user email address." + example: "pero@example.com" + bankEntries: + type: "array" + items: + $ref: "#/components/schemas/BankEntry" + description: "List of bank entries with consent status." + ExternalUserRequest: + type: "object" + properties: + name: + type: "string" + description: "External user company name." + example: "Pero Perić d.o.o." + oib: + type: "string" + description: "External user OIB (Croatian personal identification number)." + example: "12345678901" + mail: + type: "string" + description: "External user email address." + example: "pero@example.com" + bankEntries: + type: "array" + items: + $ref: "#/components/schemas/BankEntryRequest" + description: "List of bank entries to create consent jobs for." + BankEntry: + type: "object" + properties: + bankSlug: + type: "string" + description: "Bank identifier slug." + example: "erste" + ibans: + type: "array" + items: + type: "string" + description: "List of IBANs." + example: ["HR1210010051863000160"] + consentJobStatus: + type: "string" + format: "enum" + enum: ["SUCCESS", "FAILED", "PENDING"] + description: "Status of the consent job for this bank entry." + example: "PENDING" + BankEntryRequest: + type: "object" + properties: + bankSlug: + type: "string" + description: "Bank identifier slug." + example: "erste" + ibans: + type: "array" + items: + type: "string" + description: "List of IBANs." + example: ["HR1210010051863000160"] + psuIdType: + type: "string" + description: "PSU ID type for the bank consent." + example: "HRIdentificationNumber" + CreateExternalUsersResponse: + type: "object" + properties: + existingMails: + type: "array" + items: + type: "string" + description: "Email addresses that already exist in the system." + example: ["existing@example.com"] + newMails: + type: "array" + items: + type: "string" + description: "Email addresses of newly created external users." + example: ["new@example.com"] + MyResponse: + type: "object" + properties: + code: + $ref: "#/components/schemas/MyResponseCode" + message: + type: "string" + description: "The error message, present only if the \"code\" property is not \"OK\"." + example: "General error" + hasMoreResults: + type: "boolean" + description: "System limits number of transactions in response. If there are more results related to the request, this flag is set to true. In that case client should initiate a new request with the value of lastTransactionId parameter set to the greatest received transaction identifier plus 1." + example: true + data: + type: "array" + items: + oneOf: + - $ref: "#/components/schemas/AccountResult" + - $ref: "#/components/schemas/TransactionResult" + description: "List of objects related to the request." + MyResponseCode: + type: "string" + format: "enum" + enum: ["OK", "VALIDATION_FAILED", "DATA_UNAVAILABLE", "CONSENT_EXPIRED", "GENERAL_ERROR"] + description: "Represents resulting code in case when the system has handled a request." + TransactionResult: + type: "object" + properties: + id: + type: "integer" + description: "Transaction identifier from our system." + example: "123" + bankResourceId: + type: "integer" + description: "Transaction identifier from the bank." + example: "TID1234567890" + senderName: + type: "string" + description: "Sender name." + example: "Pero Perić" + senderIban: + type: "string" + description: "Sender IBAN." + example: "HR1210010051863000160" + receiverName: + type: "string" + description: "Receiver name." + example: "Miro Mirić" + receiverIban: + type: "string" + description: "Receiver IBAN." + example: "HR1210010051863000160" + amount: + type: "string" + description: "Transaction amount." + example: "123.45" + currency: + type: "string" + description: "Transaction currency." + example: "HRK" + paymentOrderExecutionDate: + type: "string" + description: "Date of the payment." + example: "2021-01-02" + description: + type: "string" + description: "Transaction description." + example: "Kupovina na POS-u Konzum Ravnice" + remittanceInformationStructured: + type: "string" + description: "Remitance information about the transaction separated by semicolon." + example: "HR99;HRXXXXXX-YYYY-ZZZZ;" + additionalInformation: + type: "string" + description: "Some additional information about the transaction separated by semicolon that isn't included in the original description, e.g. creditor or debtor address etc." + example: "creditorAddress:JURIŠIĆEVA 4, ZAGREB;debtorAddress:HRAŠĆANSKA 13, ZAGREB" + endToEndId: + type: "string" + description: "SEPA End-To-End-ID." + example: "HR99" + purposeCode: + type: "string" + description: "Transaction purpose code." + example: "WTER" + ultimateCreditor: + type: "string" + description: "Ultimate creditor name." + example: "Pero Perić" + ultimateDebtor: + type: "string" + description: "Ultimate debtor name." + example: "Miro Mirić" + responses: + InternalServerError: + description: "Internal server error." + content: + application/json: + schema: + $ref: "#/components/schemas/MyResponse" + example: + code: "GENERAL_ERROR" + message: "General error" + hasMoreResults: false + data: [] From 7072f92fae0efc76e93bc01e6ced6250fda3c194 Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Wed, 3 Jun 2026 14:39:38 +0200 Subject: [PATCH 06/16] 5137 components - gaurus - Autogenerated --- .../AbstractGaurusComponentHandler.java | 53 ++++++++ .../gaurus/GaurusComponentHandler.java | 27 ++++ .../GaurusDeleteExternalUserAction.java | 82 +++++++++++++ .../GaurusGetAccountTransactionsAction.java | 116 ++++++++++++++++++ .../action/GaurusGetAccountsAction.java | 85 +++++++++++++ .../action/GaurusGetExternalUsersAction.java | 96 +++++++++++++++ .../action/GaurusPostExternalUsersAction.java | 99 +++++++++++++++ .../action/GaurusPutExternalUserAction.java | 82 +++++++++++++ .../gaurus/connection/GaurusConnection.java | 35 ++++++ .../GaurusBankEntryRequestProperties.java | 49 ++++++++ .../property/GaurusErrorDataProperties.java | 42 +++++++ .../GaurusExternalUserRequestProperties.java | 53 ++++++++ .../property/GaurusMyResponseProperties.java | 58 +++++++++ .../GaurusServiceResponseProperties.java | 45 +++++++ .../AbstractGaurusComponentHandlerTest.java | 32 +++++ .../gaurus/GaurusComponentHandlerTest.java | 23 ++++ 16 files changed, 977 insertions(+) create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandler.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusBankEntryRequestProperties.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusErrorDataProperties.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusExternalUserRequestProperties.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusMyResponseProperties.java create mode 100644 server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusServiceResponseProperties.java create mode 100644 server/libs/modules/components/gaurus/src/test/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandlerTest.java create mode 100644 server/libs/modules/components/gaurus/src/test/java/com/bytechef/component/gaurus/GaurusComponentHandlerTest.java diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandler.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandler.java new file mode 100644 index 00000000000..e8b1b81321a --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandler.java @@ -0,0 +1,53 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus; + +import static com.bytechef.component.definition.ComponentDsl.component; + +import com.bytechef.component.OpenApiComponentHandler; +import com.bytechef.component.definition.ComponentDefinition; +import com.bytechef.component.gaurus.action.GaurusDeleteExternalUserAction; +import com.bytechef.component.gaurus.action.GaurusGetAccountTransactionsAction; +import com.bytechef.component.gaurus.action.GaurusGetAccountsAction; +import com.bytechef.component.gaurus.action.GaurusGetExternalUsersAction; +import com.bytechef.component.gaurus.action.GaurusPostExternalUsersAction; +import com.bytechef.component.gaurus.action.GaurusPutExternalUserAction; +import com.bytechef.component.gaurus.connection.GaurusConnection; + +/** + * Provides the base implementation for the REST based component. + * + * @generated + */ +public abstract class AbstractGaurusComponentHandler implements OpenApiComponentHandler { + private final ComponentDefinition componentDefinition = modifyComponent( + component("gaurus") + .title("Bank Connect") + .description("Bank Connect API specification") + .version(1)) + .actions(modifyActions(GaurusDeleteExternalUserAction.ACTION_DEFINITION, + GaurusGetAccountsAction.ACTION_DEFINITION, GaurusGetAccountTransactionsAction.ACTION_DEFINITION, + GaurusGetExternalUsersAction.ACTION_DEFINITION, GaurusPostExternalUsersAction.ACTION_DEFINITION, + GaurusPutExternalUserAction.ACTION_DEFINITION)) + .connection(modifyConnection(GaurusConnection.CONNECTION_DEFINITION)) + .triggers(getTriggers()); + + @Override + public ComponentDefinition getDefinition() { + return componentDefinition; + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java new file mode 100644 index 00000000000..d78fb18a1ec --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java @@ -0,0 +1,27 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus; + +import com.bytechef.component.OpenApiComponentHandler; +import com.google.auto.service.AutoService; + +/** + * This class will not be overwritten on the subsequent calls of the generator. + */ +@AutoService(OpenApiComponentHandler.class) +public class GaurusComponentHandler extends AbstractGaurusComponentHandler { +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java new file mode 100644 index 00000000000..bf92c5f6371 --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java @@ -0,0 +1,82 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.action; + +import static com.bytechef.component.OpenApiComponentHandler.PropertyType; +import static com.bytechef.component.definition.ComponentDsl.action; +import static com.bytechef.component.definition.ComponentDsl.dateTime; +import static com.bytechef.component.definition.ComponentDsl.integer; +import static com.bytechef.component.definition.ComponentDsl.string; + +import com.bytechef.component.definition.ComponentDsl; +import java.util.Map; + +/** + * Provides a list of the component actions. + * + * @generated + */ +public class GaurusDeleteExternalUserAction { + public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("deleteExternalUser") + .title("Deletes an external user.") + .description(null) + .metadata( + Map.of( + "method", "DELETE", + "path", "/external-users/{externalUserId}" + + )) + .properties(string("clientId").label("Client Id") + .description("Client identifer provided by the system.") + .required(true) + .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("requestId").label("Request Id") + .description("Unique identifier of a request (must be generated by client).") + .required(true) + .exampleValue("17fcaa13-eb6d-467c-a757-2e669179a19e") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + dateTime("timestamp").label("Timestamp") + .description("Current timestamp in UTC format (must be generated by client).") + .required(true) + .exampleValue("2021-01-01T11:38:20.791Z") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("signature").label("Signature") + .description( + "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
") + .required(true) + .exampleValue("ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + integer("externalUserId").label("External User Id") + .description("External user identifier.") + .required(true) + .exampleValue(42) + .metadata( + Map.of( + "type", PropertyType.PATH))); + + private GaurusDeleteExternalUserAction() { + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java new file mode 100644 index 00000000000..cf6c3c58522 --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java @@ -0,0 +1,116 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.action; + +import static com.bytechef.component.OpenApiComponentHandler.PropertyType; +import static com.bytechef.component.definition.ComponentDsl.action; +import static com.bytechef.component.definition.ComponentDsl.dateTime; +import static com.bytechef.component.definition.ComponentDsl.integer; +import static com.bytechef.component.definition.ComponentDsl.object; +import static com.bytechef.component.definition.ComponentDsl.outputSchema; +import static com.bytechef.component.definition.ComponentDsl.sampleOutput; +import static com.bytechef.component.definition.ComponentDsl.string; +import static com.bytechef.component.definition.Context.Http.ResponseType; + +import com.bytechef.component.definition.ComponentDsl; +import com.bytechef.component.gaurus.property.GaurusMyResponseProperties; +import java.util.Map; + +/** + * Provides a list of the component actions. + * + * @generated + */ +public class GaurusGetAccountTransactionsAction { + public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("getAccountTransactions") + .title("Gets transactions for provided IBAN and query parameters.") + .description( + "General rules for query parameters:
  • If lastTransactionid is provided without date parameters system will not set default values for date range (only lastTransactionId will be used for data filtering).
  • Max range between dateFrom and dateTo is 7 days. If provided date range is greater, dateFrom is set to the dateTo minus 7 days.
  • If dateFrom and dateTo are not provided:
    • dateFrom is set to the current date minus 7 days
    • dateTo is set to the current date
  • If dateFrom is provided and dateTo is not provided:
    1. If dateFrom is set to future date, it is set to the current date.
    2. dateTo is set to dateFrom plus 1 day
  • If dateFrom is not provided and dateTo is provided:
    1. If dateTo is set to future date, it is set to the current date.
    2. dateFrom is set to dateTo minus 1 day
") + .metadata( + Map.of( + "method", "GET", + "path", "/accounts/{iban}/transactions" + + )) + .properties(string("clientId").label("Client Id") + .description("Client identifer provided by the system.") + .required(true) + .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("requestId").label("Request Id") + .description("Unique identifier of a request (must be generated by client).") + .required(true) + .exampleValue("17fcaa13-eb6d-467c-a757-2e669179a19e") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + dateTime("timestamp").label("Timestamp") + .description("Current timestamp in UTC format (must be generated by client).") + .required(true) + .exampleValue("2021-01-01T11:38:20.791Z") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("signature").label("Signature") + .description( + "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
") + .required(true) + .exampleValue("ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("iban").label("Iban") + .description("Account IBAN.") + .required(true) + .exampleValue("HR1210010051863000160") + .metadata( + Map.of( + "type", PropertyType.PATH)), + string("dateFrom").label("Date From") + .description("Oldest transaction execution date.") + .required(false) + .exampleValue("2021-01-01") + .metadata( + Map.of( + "type", PropertyType.QUERY)), + string("dateTo").label("Date To") + .description("Newest transaction execution date.") + .required(false) + .exampleValue("2021-01-01") + .metadata( + Map.of( + "type", PropertyType.QUERY)), + integer("lastTransactionId").label("Last Transaction Id") + .description( + "If this parameter is specified, system will return transactions stored after the corresponding transaction.") + .required(false) + .exampleValue(123) + .metadata( + Map.of( + "type", PropertyType.QUERY))) + .output(outputSchema(object().properties(GaurusMyResponseProperties.PROPERTIES) + .metadata( + Map.of( + "responseType", ResponseType.JSON))), + sampleOutput(Map.ofEntries(Map.entry("code", "OK"), Map.entry("message", ""), + Map.entry("hasMoreResults", true), Map.entry("data", "TransactionResult[]")))); + + private GaurusGetAccountTransactionsAction() { + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java new file mode 100644 index 00000000000..a5aebda5827 --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java @@ -0,0 +1,85 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.action; + +import static com.bytechef.component.OpenApiComponentHandler.PropertyType; +import static com.bytechef.component.definition.ComponentDsl.action; +import static com.bytechef.component.definition.ComponentDsl.dateTime; +import static com.bytechef.component.definition.ComponentDsl.object; +import static com.bytechef.component.definition.ComponentDsl.outputSchema; +import static com.bytechef.component.definition.ComponentDsl.sampleOutput; +import static com.bytechef.component.definition.ComponentDsl.string; +import static com.bytechef.component.definition.Context.Http.ResponseType; + +import com.bytechef.component.definition.ComponentDsl; +import com.bytechef.component.gaurus.property.GaurusMyResponseProperties; +import java.util.Map; + +/** + * Provides a list of the component actions. + * + * @generated + */ +public class GaurusGetAccountsAction { + public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("getAccounts") + .title("Gets accounts for provided client id.") + .description(null) + .metadata( + Map.of( + "method", "GET", + "path", "/accounts" + + )) + .properties(string("clientId").label("Client Id") + .description("Client identifer provided by the system.") + .required(true) + .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("requestId").label("Request Id") + .description("Unique identifier of a request (must be generated by client).") + .required(true) + .exampleValue("17fcaa13-eb6d-467c-a757-2e669179a19e") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + dateTime("timestamp").label("Timestamp") + .description("Current timestamp in UTC format (must be generated by client).") + .required(true) + .exampleValue("2021-01-01T11:38:20.791Z") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("signature").label("Signature") + .description( + "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
") + .required(true) + .exampleValue("ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=") + .metadata( + Map.of( + "type", PropertyType.HEADER))) + .output(outputSchema(object().properties(GaurusMyResponseProperties.PROPERTIES) + .metadata( + Map.of( + "responseType", ResponseType.JSON))), + sampleOutput(Map.ofEntries(Map.entry("code", "OK"), Map.entry("message", ""), + Map.entry("hasMoreResults", false), Map.entry("data", "AccountResult[]")))); + + private GaurusGetAccountsAction() { + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java new file mode 100644 index 00000000000..7fda052cb92 --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java @@ -0,0 +1,96 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.action; + +import static com.bytechef.component.OpenApiComponentHandler.PropertyType; +import static com.bytechef.component.definition.ComponentDsl.action; +import static com.bytechef.component.definition.ComponentDsl.dateTime; +import static com.bytechef.component.definition.ComponentDsl.object; +import static com.bytechef.component.definition.ComponentDsl.outputSchema; +import static com.bytechef.component.definition.ComponentDsl.sampleOutput; +import static com.bytechef.component.definition.ComponentDsl.string; +import static com.bytechef.component.definition.Context.Http.ResponseType; + +import com.bytechef.component.definition.ComponentDsl; +import com.bytechef.component.gaurus.property.GaurusServiceResponseProperties; +import java.util.List; +import java.util.Map; + +/** + * Provides a list of the component actions. + * + * @generated + */ +public class GaurusGetExternalUsersAction { + public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("getExternalUsers") + .title("Gets external users for provided client id.") + .description(null) + .metadata( + Map.of( + "method", "GET", + "path", "/external-users" + + )) + .properties(string("clientId").label("Client Id") + .description("Client identifer provided by the system.") + .required(true) + .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("requestId").label("Request Id") + .description("Unique identifier of a request (must be generated by client).") + .required(true) + .exampleValue("17fcaa13-eb6d-467c-a757-2e669179a19e") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + dateTime("timestamp").label("Timestamp") + .description("Current timestamp in UTC format (must be generated by client).") + .required(true) + .exampleValue("2021-01-01T11:38:20.791Z") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("signature").label("Signature") + .description( + "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
") + .required(true) + .exampleValue("ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=") + .metadata( + Map.of( + "type", PropertyType.HEADER))) + .output(outputSchema(object().properties(GaurusServiceResponseProperties.PROPERTIES) + .description("Standard response wrapper for all API endpoints.") + .metadata( + Map.of( + "responseType", ResponseType.JSON))), + sampleOutput( + Map.ofEntries( + Map.entry("data", + List.of( + Map.ofEntries(Map.entry("id", 42), Map.entry("name", "Pero Perić d.o.o."), + Map.entry("oib", 1.2345678901E10), Map.entry("mail", "pero@example.com"), + Map.entry("bankEntries", + List.of(Map.ofEntries(Map.entry("bankSlug", "erste"), + Map.entry("ibans", List.of("HR1210010051863000160")), + Map.entry("consentJobStatus", "PENDING"))))))), + Map.entry("errors", List.of())))); + + private GaurusGetExternalUsersAction() { + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java new file mode 100644 index 00000000000..b3313a78019 --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java @@ -0,0 +1,99 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.action; + +import static com.bytechef.component.OpenApiComponentHandler.PropertyType; +import static com.bytechef.component.definition.ComponentDsl.action; +import static com.bytechef.component.definition.ComponentDsl.array; +import static com.bytechef.component.definition.ComponentDsl.dateTime; +import static com.bytechef.component.definition.ComponentDsl.object; +import static com.bytechef.component.definition.ComponentDsl.outputSchema; +import static com.bytechef.component.definition.ComponentDsl.sampleOutput; +import static com.bytechef.component.definition.ComponentDsl.string; +import static com.bytechef.component.definition.Context.Http.BodyContentType; +import static com.bytechef.component.definition.Context.Http.ResponseType; + +import com.bytechef.component.definition.ComponentDsl; +import com.bytechef.component.gaurus.property.GaurusExternalUserRequestProperties; +import com.bytechef.component.gaurus.property.GaurusServiceResponseProperties; +import java.util.List; +import java.util.Map; + +/** + * Provides a list of the component actions. + * + * @generated + */ +public class GaurusPostExternalUsersAction { + public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("postExternalUsers") + .title("Creates external users with bank consent jobs.") + .description(null) + .metadata( + Map.of( + "method", "POST", + "path", "/external-users", "bodyContentType", BodyContentType.JSON, "mimeType", "application/json" + + )) + .properties(string("clientId").label("Client Id") + .description("Client identifer provided by the system.") + .required(true) + .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("requestId").label("Request Id") + .description("Unique identifier of a request (must be generated by client).") + .required(true) + .exampleValue("17fcaa13-eb6d-467c-a757-2e669179a19e") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + dateTime("timestamp").label("Timestamp") + .description("Current timestamp in UTC format (must be generated by client).") + .required(true) + .exampleValue("2021-01-01T11:38:20.791Z") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("signature").label("Signature") + .description( + "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
") + .required(true) + .exampleValue("ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + array("__items").items(object().properties(GaurusExternalUserRequestProperties.PROPERTIES)) + .placeholder("Add to Items") + .metadata( + Map.of( + "type", PropertyType.BODY)) + .label("Items") + .required(true)) + .output(outputSchema(object().properties(GaurusServiceResponseProperties.PROPERTIES) + .description("Standard response wrapper for all API endpoints.") + .metadata( + Map.of( + "responseType", ResponseType.JSON))), + sampleOutput(Map.ofEntries(Map.entry("data", + List.of(Map.ofEntries(Map.entry("existingMails", List.of("existing@example.com")), + Map.entry("newMails", List.of("new@example.com"))))), + Map.entry("errors", List.of())))); + + private GaurusPostExternalUsersAction() { + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java new file mode 100644 index 00000000000..ec95933d21f --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java @@ -0,0 +1,82 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.action; + +import static com.bytechef.component.OpenApiComponentHandler.PropertyType; +import static com.bytechef.component.definition.ComponentDsl.action; +import static com.bytechef.component.definition.ComponentDsl.dateTime; +import static com.bytechef.component.definition.ComponentDsl.integer; +import static com.bytechef.component.definition.ComponentDsl.string; + +import com.bytechef.component.definition.ComponentDsl; +import java.util.Map; + +/** + * Provides a list of the component actions. + * + * @generated + */ +public class GaurusPutExternalUserAction { + public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("putExternalUser") + .title("Updates an external user.") + .description(null) + .metadata( + Map.of( + "method", "PUT", + "path", "/external-users/{externalUserId}" + + )) + .properties(string("clientId").label("Client Id") + .description("Client identifer provided by the system.") + .required(true) + .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("requestId").label("Request Id") + .description("Unique identifier of a request (must be generated by client).") + .required(true) + .exampleValue("17fcaa13-eb6d-467c-a757-2e669179a19e") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + dateTime("timestamp").label("Timestamp") + .description("Current timestamp in UTC format (must be generated by client).") + .required(true) + .exampleValue("2021-01-01T11:38:20.791Z") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + string("signature").label("Signature") + .description( + "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
") + .required(true) + .exampleValue("ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=") + .metadata( + Map.of( + "type", PropertyType.HEADER)), + integer("externalUserId").label("External User Id") + .description("External user identifier.") + .required(true) + .exampleValue(42) + .metadata( + Map.of( + "type", PropertyType.PATH))); + + private GaurusPutExternalUserAction() { + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java new file mode 100644 index 00000000000..52f1cce2334 --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java @@ -0,0 +1,35 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.connection; + +import static com.bytechef.component.definition.ComponentDsl.connection; + +import com.bytechef.component.definition.ComponentDsl; + +/** + * Provides the component connection definition. + * + * @generated + */ +public class GaurusConnection { + public static final ComponentDsl.ModifiableConnectionDefinition CONNECTION_DEFINITION = connection() + .baseUri((connectionParameters, context) -> "https://bankconnect.gaurus.hr/api/client") + .authorizations(null); + + private GaurusConnection() { + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusBankEntryRequestProperties.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusBankEntryRequestProperties.java new file mode 100644 index 00000000000..77d1dbc26c4 --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusBankEntryRequestProperties.java @@ -0,0 +1,49 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.property; + +import static com.bytechef.component.definition.ComponentDsl.array; +import static com.bytechef.component.definition.ComponentDsl.string; + +import com.bytechef.component.definition.ComponentDsl; +import java.util.List; + +/** + * Provides properties definition built from OpenAPI schema. + * + * @generated + */ +public class GaurusBankEntryRequestProperties { + public static final List> PROPERTIES = List.of( + string("bankSlug").label("Bank Slug") + .description("Bank identifier slug.") + .required(false) + .exampleValue("erste"), + array("ibans").items(string().description("List of IBANs.")) + .placeholder("Add to Ibans") + .label("Ibans") + .description("List of IBANs.") + .required(false) + .exampleValue("HR1210010051863000160"), + string("psuIdType").label("Psu Id Type") + .description("PSU ID type for the bank consent.") + .required(false) + .exampleValue("HRIdentificationNumber")); + + private GaurusBankEntryRequestProperties() { + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusErrorDataProperties.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusErrorDataProperties.java new file mode 100644 index 00000000000..52bdd997e1f --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusErrorDataProperties.java @@ -0,0 +1,42 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.property; + +import static com.bytechef.component.definition.ComponentDsl.string; + +import com.bytechef.component.definition.ComponentDsl; +import java.util.List; + +/** + * Provides properties definition built from OpenAPI schema. + * + * @generated + */ +public class GaurusErrorDataProperties { + public static final List> PROPERTIES = List.of( + string("code").label("Code") + .description("Error code.") + .required(false) + .exampleValue("GENERAL_ERROR"), + string("description").label("Description") + .description("Error description.") + .required(false) + .exampleValue("General error")); + + private GaurusErrorDataProperties() { + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusExternalUserRequestProperties.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusExternalUserRequestProperties.java new file mode 100644 index 00000000000..94df4fbc619 --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusExternalUserRequestProperties.java @@ -0,0 +1,53 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.property; + +import static com.bytechef.component.definition.ComponentDsl.array; +import static com.bytechef.component.definition.ComponentDsl.object; +import static com.bytechef.component.definition.ComponentDsl.string; + +import com.bytechef.component.definition.ComponentDsl; +import java.util.List; + +/** + * Provides properties definition built from OpenAPI schema. + * + * @generated + */ +public class GaurusExternalUserRequestProperties { + public static final List> PROPERTIES = List.of( + string("name").label("Name") + .description("External user company name.") + .required(false) + .exampleValue("Pero Perić d.o.o."), + string("oib").label("Oib") + .description("External user OIB (Croatian personal identification number).") + .required(false) + .exampleValue("12345678901"), + string("mail").label("Mail") + .description("External user email address.") + .required(false) + .exampleValue("pero@example.com"), + array("bankEntries").items(object().properties(GaurusBankEntryRequestProperties.PROPERTIES)) + .placeholder("Add to Bank Entries") + .label("Bank Entries") + .description("List of bank entries to create consent jobs for.") + .required(false)); + + private GaurusExternalUserRequestProperties() { + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusMyResponseProperties.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusMyResponseProperties.java new file mode 100644 index 00000000000..f2c63fdf823 --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusMyResponseProperties.java @@ -0,0 +1,58 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.property; + +import static com.bytechef.component.definition.ComponentDsl.array; +import static com.bytechef.component.definition.ComponentDsl.bool; +import static com.bytechef.component.definition.ComponentDsl.object; +import static com.bytechef.component.definition.ComponentDsl.option; +import static com.bytechef.component.definition.ComponentDsl.string; + +import com.bytechef.component.definition.ComponentDsl; +import java.util.List; + +/** + * Provides properties definition built from OpenAPI schema. + * + * @generated + */ +public class GaurusMyResponseProperties { + public static final List> PROPERTIES = List.of( + string("code").label("Code") + .description("Represents resulting code in case when the system has handled a request.") + .options(option("OK", "OK"), option("VALIDATION_FAILED", "VALIDATION_FAILED"), + option("DATA_UNAVAILABLE", "DATA_UNAVAILABLE"), option("CONSENT_EXPIRED", "CONSENT_EXPIRED"), + option("GENERAL_ERROR", "GENERAL_ERROR")) + .required(false), + string("message").label("Message") + .description("The error message, present only if the \"code\" property is not \"OK\".") + .required(false) + .exampleValue("General error"), + bool("hasMoreResults").label("Has More Results") + .description( + "System limits number of transactions in response. If there are more results related to the request, this flag is set to true. In that case client should initiate a new request with the value of lastTransactionId parameter set to the greatest received transaction identifer plus 1.") + .required(false) + .exampleValue(true), + array("data").items(object().description("List of objects related to the request.")) + .placeholder("Add to Data") + .label("Data") + .description("List of objects related to the request.") + .required(false)); + + private GaurusMyResponseProperties() { + } +} diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusServiceResponseProperties.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusServiceResponseProperties.java new file mode 100644 index 00000000000..b32e14b96e5 --- /dev/null +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusServiceResponseProperties.java @@ -0,0 +1,45 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus.property; + +import static com.bytechef.component.definition.ComponentDsl.array; +import static com.bytechef.component.definition.ComponentDsl.object; + +import com.bytechef.component.definition.ComponentDsl; +import java.util.List; + +/** + * Provides properties definition built from OpenAPI schema. + * + * @generated + */ +public class GaurusServiceResponseProperties { + public static final List> PROPERTIES = List.of( + array("data").items(object().description("List of results (empty if the response is not valid).")) + .placeholder("Add to Data") + .label("Data") + .description("List of results (empty if the response is not valid).") + .required(false), + array("errors").items(object().properties(GaurusErrorDataProperties.PROPERTIES)) + .placeholder("Add to Errors") + .label("Errors") + .description("List of errors (empty if the response is valid).") + .required(false)); + + private GaurusServiceResponseProperties() { + } +} diff --git a/server/libs/modules/components/gaurus/src/test/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandlerTest.java b/server/libs/modules/components/gaurus/src/test/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandlerTest.java new file mode 100644 index 00000000000..50ccfeb83c2 --- /dev/null +++ b/server/libs/modules/components/gaurus/src/test/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandlerTest.java @@ -0,0 +1,32 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus; + +import com.bytechef.test.jsonasssert.JsonFileAssert; +import org.junit.jupiter.api.Test; + +/** + * Provides the base test implementation for the REST based component. + * + * @generated + */ +public abstract class AbstractGaurusComponentHandlerTest { + @Test + public void testGetDefinition() { + JsonFileAssert.assertEquals("definition/gaurus_v1.json", new GaurusComponentHandler().getDefinition()); + } +} diff --git a/server/libs/modules/components/gaurus/src/test/java/com/bytechef/component/gaurus/GaurusComponentHandlerTest.java b/server/libs/modules/components/gaurus/src/test/java/com/bytechef/component/gaurus/GaurusComponentHandlerTest.java new file mode 100644 index 00000000000..387248fdc0e --- /dev/null +++ b/server/libs/modules/components/gaurus/src/test/java/com/bytechef/component/gaurus/GaurusComponentHandlerTest.java @@ -0,0 +1,23 @@ +/* + * Copyright 2025 ByteChef + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * https://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.bytechef.component.gaurus; + +/** + * @generated + */ +public class GaurusComponentHandlerTest extends AbstractGaurusComponentHandlerTest { +} From ef9d4fe49e6b66f3597c4215464157d623d012e8 Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Wed, 3 Jun 2026 14:48:24 +0200 Subject: [PATCH 07/16] 5137 components - gaurus - manually fix autogenerated code --- .../component/gaurus/action/GaurusDeleteExternalUserAction.java | 1 - .../gaurus/action/GaurusGetAccountTransactionsAction.java | 1 - .../component/gaurus/action/GaurusGetAccountsAction.java | 1 - .../component/gaurus/action/GaurusGetExternalUsersAction.java | 1 - .../component/gaurus/action/GaurusPostExternalUsersAction.java | 1 - .../component/gaurus/action/GaurusPutExternalUserAction.java | 1 - .../bytechef/component/gaurus/connection/GaurusConnection.java | 2 +- 7 files changed, 1 insertion(+), 7 deletions(-) diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java index bf92c5f6371..dc12e717004 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java @@ -57,7 +57,6 @@ public class GaurusDeleteExternalUserAction { dateTime("timestamp").label("Timestamp") .description("Current timestamp in UTC format (must be generated by client).") .required(true) - .exampleValue("2021-01-01T11:38:20.791Z") .metadata( Map.of( "type", PropertyType.HEADER)), diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java index cf6c3c58522..39646b3314b 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java @@ -63,7 +63,6 @@ public class GaurusGetAccountTransactionsAction { dateTime("timestamp").label("Timestamp") .description("Current timestamp in UTC format (must be generated by client).") .required(true) - .exampleValue("2021-01-01T11:38:20.791Z") .metadata( Map.of( "type", PropertyType.HEADER)), diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java index a5aebda5827..4a9ad3961b8 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java @@ -61,7 +61,6 @@ public class GaurusGetAccountsAction { dateTime("timestamp").label("Timestamp") .description("Current timestamp in UTC format (must be generated by client).") .required(true) - .exampleValue("2021-01-01T11:38:20.791Z") .metadata( Map.of( "type", PropertyType.HEADER)), diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java index 7fda052cb92..c6412d039d3 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java @@ -62,7 +62,6 @@ public class GaurusGetExternalUsersAction { dateTime("timestamp").label("Timestamp") .description("Current timestamp in UTC format (must be generated by client).") .required(true) - .exampleValue("2021-01-01T11:38:20.791Z") .metadata( Map.of( "type", PropertyType.HEADER)), diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java index b3313a78019..8e3f7973b2c 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java @@ -65,7 +65,6 @@ public class GaurusPostExternalUsersAction { dateTime("timestamp").label("Timestamp") .description("Current timestamp in UTC format (must be generated by client).") .required(true) - .exampleValue("2021-01-01T11:38:20.791Z") .metadata( Map.of( "type", PropertyType.HEADER)), diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java index ec95933d21f..4c36bb4875e 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java @@ -57,7 +57,6 @@ public class GaurusPutExternalUserAction { dateTime("timestamp").label("Timestamp") .description("Current timestamp in UTC format (must be generated by client).") .required(true) - .exampleValue("2021-01-01T11:38:20.791Z") .metadata( Map.of( "type", PropertyType.HEADER)), diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java index 52f1cce2334..598543cb266 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java @@ -28,7 +28,7 @@ public class GaurusConnection { public static final ComponentDsl.ModifiableConnectionDefinition CONNECTION_DEFINITION = connection() .baseUri((connectionParameters, context) -> "https://bankconnect.gaurus.hr/api/client") - .authorizations(null); + .authorizations((ComponentDsl.ModifiableAuthorization[]) null); private GaurusConnection() { } From b039ba60f3dd2745bbd5d7c0bcecb29ffde272f4 Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Wed, 3 Jun 2026 15:30:12 +0200 Subject: [PATCH 08/16] 5137 components - gaurus - initial implementation --- .../action/GaurusGetExternalUsersAction.java | 51 +++++++++++++++++++ .../gaurus/connection/GaurusConnection.java | 14 ++++- 2 files changed, 64 insertions(+), 1 deletion(-) diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java index c6412d039d3..58e5beb56a9 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java @@ -25,10 +25,20 @@ import static com.bytechef.component.definition.ComponentDsl.string; import static com.bytechef.component.definition.Context.Http.ResponseType; +import com.bytechef.component.definition.ActionContext; import com.bytechef.component.definition.ComponentDsl; +import com.bytechef.component.definition.Context.Http.Executor; +import com.bytechef.component.definition.Context.Http.Response; +import com.bytechef.component.definition.Parameters; import com.bytechef.component.gaurus.property.GaurusServiceResponseProperties; +import java.nio.charset.StandardCharsets; +import java.security.InvalidKeyException; +import java.security.NoSuchAlgorithmException; +import java.util.Base64; import java.util.List; import java.util.Map; +import javax.crypto.Mac; +import javax.crypto.spec.SecretKeySpec; /** * Provides a list of the component actions. @@ -36,6 +46,7 @@ * @generated */ public class GaurusGetExternalUsersAction { + private static final String ENDPOINT_URL = "/external-users"; public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("getExternalUsers") .title("Gets external users for provided client id.") .description(null) @@ -92,4 +103,44 @@ public class GaurusGetExternalUsersAction { private GaurusGetExternalUsersAction() { } + + public static Object perform(Parameters inputParameters, Parameters connectionParameters, ActionContext context) { + String endpoint = connectionParameters.getRequiredString("baseUri") + ENDPOINT_URL; + + Executor httpExecutor = context.http(http -> http.get(endpoint)); + String requestId = "SHOUD-GENERATE-0001"; + String timestamp = String.valueOf(System.currentTimeMillis()); + String clientId = (String) connectionParameters.get("clientId"); + String clientSecret = (String) connectionParameters.get("clientSecret"); + + Response response = httpExecutor + .headers(Map.of("clienId", List.of(clientId), "requestId", + List.of(requestId), "timestamp", List.of(timestamp), + "signature", List.of(getSignature(clientId, clientSecret, requestId, timestamp, endpoint)))) + .execute(); + + return response.getBody(); + } + + private static String + getSignature(String clientId, String clientSecret, String requestId, String timestamp, String uri) { + String forSigning = String.format("%s;%s;%s;%s;", clientId, requestId, timestamp, uri); + + try { + Mac mac = Mac.getInstance("HmacSHA256"); + + mac.init(new SecretKeySpec(clientSecret.getBytes(StandardCharsets.UTF_8), "HmacSHA256")); + + return Base64.getEncoder() + .encodeToString(mac.doFinal(forSigning.getBytes(StandardCharsets.UTF_8))); + } catch (InvalidKeyException | NoSuchAlgorithmException exception) { + throw new RuntimeException("Failed to compute HmacSHA256 signature", exception); + } + } + + public static final String HEADER = "header"; + public static final String QUERY = "query"; + public static final String PATH = "path"; + public static final String BODY = "body"; + public static final String PROPERTIES = "properties"; } diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java index 598543cb266..245dd9f5507 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java @@ -16,8 +16,11 @@ package com.bytechef.component.gaurus.connection; +import static com.bytechef.component.definition.ComponentDsl.authorization; import static com.bytechef.component.definition.ComponentDsl.connection; +import static com.bytechef.component.definition.ComponentDsl.string; +import com.bytechef.component.definition.Authorization; import com.bytechef.component.definition.ComponentDsl; /** @@ -28,7 +31,16 @@ public class GaurusConnection { public static final ComponentDsl.ModifiableConnectionDefinition CONNECTION_DEFINITION = connection() .baseUri((connectionParameters, context) -> "https://bankconnect.gaurus.hr/api/client") - .authorizations((ComponentDsl.ModifiableAuthorization[]) null); + .properties(string("baseUri").label("Service URI") + .description("The base URI of the Gaurus service")) + .authorizationRequired(true) + .authorizations(authorization(Authorization.AuthorizationType.CUSTOM).title("Gaurus HmacSHA256 Authorization") + .properties(string("clientId").label("Client ID") + .description("Client Id generated at GAURUS") + .required(true), + string("clientSecret").label("Client Secret") + .description("The secret key for digital signing") + .required(true))); private GaurusConnection() { } From 8cd55aab17ac98269e285d7219fe269463a8af3e Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Wed, 3 Jun 2026 18:59:04 +0200 Subject: [PATCH 09/16] 5137 components - gaurus - move to handler (probably we have to re-think if we will lean to OpenAPI here because of too much custom coding) --- .../gaurus/GaurusComponentHandler.java | 76 +++++++++++++++++++ .../action/GaurusGetExternalUsersAction.java | 52 +------------ .../gaurus/connection/GaurusConnection.java | 17 ++++- 3 files changed, 91 insertions(+), 54 deletions(-) diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java index d78fb18a1ec..3fab192d3b9 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java @@ -17,11 +17,87 @@ package com.bytechef.component.gaurus; import com.bytechef.component.OpenApiComponentHandler; +import com.bytechef.component.definition.ActionContext; +import com.bytechef.component.definition.ActionDefinition; +import com.bytechef.component.definition.ComponentDsl; +import com.bytechef.component.definition.Context; +import com.bytechef.component.definition.Parameters; import com.google.auto.service.AutoService; +import java.nio.charset.StandardCharsets; +import java.security.InvalidKeyException; +import java.security.NoSuchAlgorithmException; +import java.util.Base64; +import java.util.Collections; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.Optional; +import javax.crypto.Mac; +import javax.crypto.spec.SecretKeySpec; +import org.apache.commons.lang3.time.DateFormatUtils; /** * This class will not be overwritten on the subsequent calls of the generator. + * + * @author Igor Beslic */ @AutoService(OpenApiComponentHandler.class) public class GaurusComponentHandler extends AbstractGaurusComponentHandler { + + public ComponentDsl.ModifiableActionDefinition + modifyAction(ComponentDsl.ModifiableActionDefinition modifiableActionDefinition) { + if (Objects.equals("getExternalUsers", modifiableActionDefinition.getName())) { + Optional> metadata = modifiableActionDefinition.getMetadata(); + + Map metadataMap = metadata.orElseGet(Collections::emptyMap); + + String path = (String) metadataMap.get("path"); + + modifiableActionDefinition.perform(new ActionDefinition.PerformFunction() { + @Override + public Object apply(Parameters inputParameters, Parameters connectionParameters, ActionContext context) + throws Exception { + String endpoint = + connectionParameters.getRequiredString("baseUri") + path; + + Context.Http.Executor httpExecutor = context.http(http -> http.get(endpoint)); + + String clientId = connectionParameters.getString("clientId"); + String clientSecret = connectionParameters.getString("clientSecret"); + String requestId = "SHOUD-GENERATE-0001"; + String timestamp = + DateFormatUtils.ISO_8601_EXTENDED_DATETIME_TIME_ZONE_FORMAT.format(System.currentTimeMillis()); + + Context.Http.Response response = httpExecutor + .configuration(Context.Http + .allowUnauthorizedCerts(connectionParameters.getBoolean("allowSelfSignedCert", false))) + .headers(Map.of("clienId", List.of(clientId), "requestId", + List.of(requestId), "timestamp", List.of(timestamp), + "signature", List.of(getSignature(clientId, clientSecret, requestId, timestamp, endpoint)))) + .execute(); + + return response.getBody(); + } + }); + } + + return modifiableActionDefinition; + } + + private static String getSignature( + String clientId, String clientSecret, String requestId, String timestamp, String uri) { + + String forSigning = String.format("%s;%s;%s;%s;", clientId, requestId, timestamp, uri); + + try { + Mac mac = Mac.getInstance("HmacSHA256"); + + mac.init(new SecretKeySpec(clientSecret.getBytes(StandardCharsets.UTF_8), "HmacSHA256")); + + return Base64.getEncoder() + .encodeToString(mac.doFinal(forSigning.getBytes(StandardCharsets.UTF_8))); + } catch (InvalidKeyException | NoSuchAlgorithmException exception) { + throw new RuntimeException("Failed to compute HmacSHA256 signature", exception); + } + } } diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java index 58e5beb56a9..c11a253986a 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java @@ -25,28 +25,19 @@ import static com.bytechef.component.definition.ComponentDsl.string; import static com.bytechef.component.definition.Context.Http.ResponseType; -import com.bytechef.component.definition.ActionContext; import com.bytechef.component.definition.ComponentDsl; -import com.bytechef.component.definition.Context.Http.Executor; -import com.bytechef.component.definition.Context.Http.Response; -import com.bytechef.component.definition.Parameters; import com.bytechef.component.gaurus.property.GaurusServiceResponseProperties; -import java.nio.charset.StandardCharsets; -import java.security.InvalidKeyException; -import java.security.NoSuchAlgorithmException; -import java.util.Base64; import java.util.List; import java.util.Map; -import javax.crypto.Mac; -import javax.crypto.spec.SecretKeySpec; /** * Provides a list of the component actions. * * @generated + * @author Igor Beslic */ public class GaurusGetExternalUsersAction { - private static final String ENDPOINT_URL = "/external-users"; + public static final String ENDPOINT_URL = "/external-users"; public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("getExternalUsers") .title("Gets external users for provided client id.") .description(null) @@ -104,43 +95,4 @@ public class GaurusGetExternalUsersAction { private GaurusGetExternalUsersAction() { } - public static Object perform(Parameters inputParameters, Parameters connectionParameters, ActionContext context) { - String endpoint = connectionParameters.getRequiredString("baseUri") + ENDPOINT_URL; - - Executor httpExecutor = context.http(http -> http.get(endpoint)); - String requestId = "SHOUD-GENERATE-0001"; - String timestamp = String.valueOf(System.currentTimeMillis()); - String clientId = (String) connectionParameters.get("clientId"); - String clientSecret = (String) connectionParameters.get("clientSecret"); - - Response response = httpExecutor - .headers(Map.of("clienId", List.of(clientId), "requestId", - List.of(requestId), "timestamp", List.of(timestamp), - "signature", List.of(getSignature(clientId, clientSecret, requestId, timestamp, endpoint)))) - .execute(); - - return response.getBody(); - } - - private static String - getSignature(String clientId, String clientSecret, String requestId, String timestamp, String uri) { - String forSigning = String.format("%s;%s;%s;%s;", clientId, requestId, timestamp, uri); - - try { - Mac mac = Mac.getInstance("HmacSHA256"); - - mac.init(new SecretKeySpec(clientSecret.getBytes(StandardCharsets.UTF_8), "HmacSHA256")); - - return Base64.getEncoder() - .encodeToString(mac.doFinal(forSigning.getBytes(StandardCharsets.UTF_8))); - } catch (InvalidKeyException | NoSuchAlgorithmException exception) { - throw new RuntimeException("Failed to compute HmacSHA256 signature", exception); - } - } - - public static final String HEADER = "header"; - public static final String QUERY = "query"; - public static final String PATH = "path"; - public static final String BODY = "body"; - public static final String PROPERTIES = "properties"; } diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java index 245dd9f5507..ff74cae6e91 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/connection/GaurusConnection.java @@ -17,6 +17,7 @@ package com.bytechef.component.gaurus.connection; import static com.bytechef.component.definition.ComponentDsl.authorization; +import static com.bytechef.component.definition.ComponentDsl.bool; import static com.bytechef.component.definition.ComponentDsl.connection; import static com.bytechef.component.definition.ComponentDsl.string; @@ -27,6 +28,8 @@ * Provides the component connection definition. * * @generated + * + * @author Igor Beslic */ public class GaurusConnection { public static final ComponentDsl.ModifiableConnectionDefinition CONNECTION_DEFINITION = connection() @@ -35,12 +38,18 @@ public class GaurusConnection { .description("The base URI of the Gaurus service")) .authorizationRequired(true) .authorizations(authorization(Authorization.AuthorizationType.CUSTOM).title("Gaurus HmacSHA256 Authorization") - .properties(string("clientId").label("Client ID") - .description("Client Id generated at GAURUS") - .required(true), + .properties( + string("clientId").label("Client ID") + .description("Client Id generated at GAURUS") + .required(true), string("clientSecret").label("Client Secret") .description("The secret key for digital signing") - .required(true))); + .required(true), + bool("allowSelfSignedCert").label("Allow Self-Signed Certificates") + .description("Allow secure connections to servers with self-signed certificates") + .defaultValue(false)) + + ); private GaurusConnection() { } From 7b129889d661f05277190ef47ce40527715ca243 Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Wed, 3 Jun 2026 18:59:19 +0200 Subject: [PATCH 10/16] 5137 components - gaurus - author --- .../component/gaurus/AbstractGaurusComponentHandler.java | 2 ++ .../component/gaurus/action/GaurusDeleteExternalUserAction.java | 2 ++ .../gaurus/action/GaurusGetAccountTransactionsAction.java | 2 ++ .../component/gaurus/action/GaurusGetAccountsAction.java | 2 ++ .../component/gaurus/action/GaurusPostExternalUsersAction.java | 2 ++ .../component/gaurus/action/GaurusPutExternalUserAction.java | 2 ++ 6 files changed, 12 insertions(+) diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandler.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandler.java index e8b1b81321a..4ab40518c7c 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandler.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/AbstractGaurusComponentHandler.java @@ -32,6 +32,8 @@ * Provides the base implementation for the REST based component. * * @generated + * + * @author Igor Beslic */ public abstract class AbstractGaurusComponentHandler implements OpenApiComponentHandler { private final ComponentDefinition componentDefinition = modifyComponent( diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java index dc12e717004..9ac8be446ef 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java @@ -29,6 +29,8 @@ * Provides a list of the component actions. * * @generated + * + * @author Igor Beslic */ public class GaurusDeleteExternalUserAction { public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("deleteExternalUser") diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java index 39646b3314b..7208579333e 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java @@ -34,6 +34,8 @@ * Provides a list of the component actions. * * @generated + * + * @author Igor Beslic */ public class GaurusGetAccountTransactionsAction { public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("getAccountTransactions") diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java index 4a9ad3961b8..df6f34019b8 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java @@ -33,6 +33,8 @@ * Provides a list of the component actions. * * @generated + * + * @author Igor Beslic */ public class GaurusGetAccountsAction { public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("getAccounts") diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java index 8e3f7973b2c..f980fcb7840 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java @@ -37,6 +37,8 @@ * Provides a list of the component actions. * * @generated + * + * @author Igor Beslic */ public class GaurusPostExternalUsersAction { public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("postExternalUsers") diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java index 4c36bb4875e..2d257fba1a3 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java @@ -29,6 +29,8 @@ * Provides a list of the component actions. * * @generated + * + * @author Igor Beslic */ public class GaurusPutExternalUserAction { public static final ComponentDsl.ModifiableActionDefinition ACTION_DEFINITION = action("putExternalUser") From 19b28147b1d65c169b3d7ae1b4e46677531af765 Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Fri, 5 Jun 2026 11:00:24 +0200 Subject: [PATCH 11/16] 5137 generator - openapi - fix issues --- .../ComponentInitOpenApiGenerator.java | 46 +++++++++++++------ 1 file changed, 33 insertions(+), 13 deletions(-) diff --git a/cli/commands/component/init/openapi/src/main/java/com/bytechef/cli/command/component/init/openapi/ComponentInitOpenApiGenerator.java b/cli/commands/component/init/openapi/src/main/java/com/bytechef/cli/command/component/init/openapi/ComponentInitOpenApiGenerator.java index 773648ce1af..83fc6d4a69e 100644 --- a/cli/commands/component/init/openapi/src/main/java/com/bytechef/cli/command/component/init/openapi/ComponentInitOpenApiGenerator.java +++ b/cli/commands/component/init/openapi/src/main/java/com/bytechef/cli/command/component/init/openapi/ComponentInitOpenApiGenerator.java @@ -91,6 +91,7 @@ import javax.tools.JavaCompiler; import javax.tools.ToolProvider; import org.apache.commons.lang3.StringUtils; +import org.jspecify.annotations.NonNull; import org.slf4j.Logger; import org.slf4j.LoggerFactory; @@ -1615,8 +1616,8 @@ private String getPackageName() { } private CodeBlock getParametersPropertiesCodeBlock(Operation operation, OpenAPI openAPI) { - List codeBlocks = new ArrayList<>(); List parameters = resolveParameters(operation.getParameters(), openAPI); + List codeBlocks = new ArrayList<>(); for (Parameter parameter : parameters) { CodeBlock.Builder builder = CodeBlock.builder(); @@ -1745,6 +1746,10 @@ private CodeBlock getRefCodeBlock( } private List resolveParameters(List parameters, OpenAPI openAPI) { + if (parameters == null) { + return Collections.emptyList(); + } + List resolvedParameters = new ArrayList<>(); parameters.forEach(explicitParameter -> { @@ -1754,24 +1759,39 @@ private List resolveParameters(List parameters, OpenAPI op return; } - String parameterReference = explicitParameter.get$ref(); + resolvedParameters.add(getComponentParameter(openAPI, explicitParameter)); + }); - if (parameterReference.startsWith("#/components/parameters/")) { - parameterReference = parameterReference.substring("#/components/paramaters/".length()); - } + return resolvedParameters; + } - Components components = openAPI.getComponents(); + private static @NonNull Parameter getComponentParameter(OpenAPI openAPI, Parameter explicitParameter) { + Components components = openAPI.getComponents(); - Map parameterDefinitions = components.getParameters(); + if (components == null) { + throw new IllegalArgumentException( + "Components section of spec misses. Unable to resolve " + explicitParameter.get$ref()); + } - if (!parameterDefinitions.containsKey(parameterReference)) { - throw new IllegalArgumentException("Missing parameter definition for " + explicitParameter.get$ref()); - } + Map parameterDefinitions = components.getParameters(); + String parameterName = getParameterNameFromComponentReference(explicitParameter); - resolvedParameters.add(parameterDefinitions.get(parameterReference)); - }); + if ((parameterDefinitions == null) || !parameterDefinitions.containsKey(parameterName)) { + throw new IllegalArgumentException( + "Components section of spec misses the parameter definition for " + explicitParameter.get$ref()); + } - return resolvedParameters; + return parameterDefinitions.get(parameterName); + } + + private static String getParameterNameFromComponentReference(Parameter parameter) { + String parameterReference = parameter.get$ref(); + + if (parameterReference.startsWith("#/components/parameters/")) { + parameterReference = parameterReference.substring("#/components/parameters/".length()); + } + + return parameterReference; } @SuppressWarnings({ From dbf76cc37582d23e7af92fc4cd47382f019be7df Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Fri, 5 Jun 2026 12:09:27 +0200 Subject: [PATCH 12/16] 5137 component - gaurus - fix typo and cover all cases in definition --- .../GaurusDeleteExternalUserAction.java | 2 +- .../GaurusGetAccountTransactionsAction.java | 2 +- .../action/GaurusGetAccountsAction.java | 2 +- .../action/GaurusGetExternalUsersAction.java | 2 +- .../action/GaurusPostExternalUsersAction.java | 2 +- .../action/GaurusPutExternalUserAction.java | 2 +- .../property/GaurusMyResponseProperties.java | 2 +- .../test/resources/definition/gaurus_v1.json | 2492 +++++++++++++++++ 8 files changed, 2499 insertions(+), 7 deletions(-) create mode 100644 server/libs/modules/components/gaurus/src/test/resources/definition/gaurus_v1.json diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java index 9ac8be446ef..20b11a7c9d3 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusDeleteExternalUserAction.java @@ -43,7 +43,7 @@ public class GaurusDeleteExternalUserAction { )) .properties(string("clientId").label("Client Id") - .description("Client identifer provided by the system.") + .description("Client identifier provided by the system.") .required(true) .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") .metadata( diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java index 7208579333e..8ffe7237758 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountTransactionsAction.java @@ -49,7 +49,7 @@ public class GaurusGetAccountTransactionsAction { )) .properties(string("clientId").label("Client Id") - .description("Client identifer provided by the system.") + .description("Client identifier provided by the system.") .required(true) .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") .metadata( diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java index df6f34019b8..8358d3435ba 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetAccountsAction.java @@ -47,7 +47,7 @@ public class GaurusGetAccountsAction { )) .properties(string("clientId").label("Client Id") - .description("Client identifer provided by the system.") + .description("Client identifier provided by the system.") .required(true) .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") .metadata( diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java index c11a253986a..2cc64a16561 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusGetExternalUsersAction.java @@ -48,7 +48,7 @@ public class GaurusGetExternalUsersAction { )) .properties(string("clientId").label("Client Id") - .description("Client identifer provided by the system.") + .description("Client identifier provided by the system.") .required(true) .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") .metadata( diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java index f980fcb7840..24a82ec5279 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPostExternalUsersAction.java @@ -51,7 +51,7 @@ public class GaurusPostExternalUsersAction { )) .properties(string("clientId").label("Client Id") - .description("Client identifer provided by the system.") + .description("Client identifier provided by the system.") .required(true) .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") .metadata( diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java index 2d257fba1a3..b289c7c75c2 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/action/GaurusPutExternalUserAction.java @@ -43,7 +43,7 @@ public class GaurusPutExternalUserAction { )) .properties(string("clientId").label("Client Id") - .description("Client identifer provided by the system.") + .description("Client identifier provided by the system.") .required(true) .exampleValue("4181a492-97bf-48ee-b29e-d7d6860c5565") .metadata( diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusMyResponseProperties.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusMyResponseProperties.java index f2c63fdf823..e812b191db5 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusMyResponseProperties.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/property/GaurusMyResponseProperties.java @@ -44,7 +44,7 @@ public class GaurusMyResponseProperties { .exampleValue("General error"), bool("hasMoreResults").label("Has More Results") .description( - "System limits number of transactions in response. If there are more results related to the request, this flag is set to true. In that case client should initiate a new request with the value of lastTransactionId parameter set to the greatest received transaction identifer plus 1.") + "System limits number of transactions in response. If there are more results related to the request, this flag is set to true. In that case client should initiate a new request with the value of lastTransactionId parameter set to the greatest received transaction identifier plus 1.") .required(false) .exampleValue(true), array("data").items(object().description("List of objects related to the request.")) diff --git a/server/libs/modules/components/gaurus/src/test/resources/definition/gaurus_v1.json b/server/libs/modules/components/gaurus/src/test/resources/definition/gaurus_v1.json new file mode 100644 index 00000000000..613e26efdfb --- /dev/null +++ b/server/libs/modules/components/gaurus/src/test/resources/definition/gaurus_v1.json @@ -0,0 +1,2492 @@ +{ + "actions": [ { + "batch": null, + "beforeResume": null, + "beforeSuspend": null, + "beforeTimeoutResume": null, + "deprecated": null, + "description": null, + "help": null, + "metadata": { + "method": "DELETE", + "path": "/external-users/{externalUserId}" + }, + "name": "deleteExternalUser", + "outputDefinition": null, + "perform": { }, + "processErrorResponse": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Client identifier provided by the system.", + "displayCondition": null, + "exampleValue": "4181a492-97bf-48ee-b29e-d7d6860c5565", + "expressionEnabled": null, + "hidden": null, + "label": "Client Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "clientId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Unique identifier of a request (must be generated by client).", + "displayCondition": null, + "exampleValue": "17fcaa13-eb6d-467c-a757-2e669179a19e", + "expressionEnabled": null, + "hidden": null, + "label": "Request Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "requestId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "DATE_TIME", + "defaultValue": null, + "description": "Current timestamp in UTC format (must be generated by client).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Timestamp", + "metadata": { + "type": "HEADER" + }, + "name": "timestamp", + "options": null, + "optionsDataSource": null, + "placeholder": null, + "required": true, + "type": "DATE_TIME" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
", + "displayCondition": null, + "exampleValue": "ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=", + "expressionEnabled": null, + "hidden": null, + "label": "Signature", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "signature", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "INTEGER", + "defaultValue": null, + "description": "External user identifier.", + "displayCondition": null, + "exampleValue": 42, + "expressionEnabled": null, + "hidden": null, + "label": "External User Id", + "maxValue": null, + "metadata": { + "type": "PATH" + }, + "minValue": null, + "name": "externalUserId", + "options": null, + "optionsDataSource": null, + "placeholder": null, + "required": true, + "type": "INTEGER" + } ], + "resumePerform": null, + "title": "Deletes an external user.", + "workflowNodeDescription": null + }, { + "batch": null, + "beforeResume": null, + "beforeSuspend": null, + "beforeTimeoutResume": null, + "deprecated": null, + "description": null, + "help": null, + "metadata": { + "method": "GET", + "path": "/accounts" + }, + "name": "getAccounts", + "outputDefinition": { + "output": null, + "outputResponse": { + "outputSchema": { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": null, + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { + "responseType": { + "contentType": "application/json", + "type": "JSON" + } + }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "SELECT", + "defaultValue": null, + "description": "Represents resulting code in case when the system has handled a request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Code", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "code", + "options": [ { + "description": null, + "label": "OK", + "value": "OK" + }, { + "description": null, + "label": "VALIDATION_FAILED", + "value": "VALIDATION_FAILED" + }, { + "description": null, + "label": "DATA_UNAVAILABLE", + "value": "DATA_UNAVAILABLE" + }, { + "description": null, + "label": "CONSENT_EXPIRED", + "value": "CONSENT_EXPIRED" + }, { + "description": null, + "label": "GENERAL_ERROR", + "value": "GENERAL_ERROR" + } ], + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "The error message, present only if the \"code\" property is not \"OK\".", + "displayCondition": null, + "exampleValue": "General error", + "expressionEnabled": null, + "hidden": null, + "label": "Message", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "message", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "SELECT", + "defaultValue": null, + "description": "System limits number of transactions in response. If there are more results related to the request, this flag is set to true. In that case client should initiate a new request with the value of lastTransactionId parameter set to the greatest received transaction identifier plus 1.", + "displayCondition": null, + "exampleValue": true, + "expressionEnabled": null, + "hidden": null, + "label": "Has More Results", + "metadata": { }, + "name": "hasMoreResults", + "options": [ { + "description": null, + "label": "True", + "value": true + }, { + "description": null, + "label": "False", + "value": false + } ], + "placeholder": null, + "required": false, + "type": "BOOLEAN" + }, { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of objects related to the request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "List of objects related to the request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": null, + "required": null, + "type": "OBJECT" + } ], + "label": "Data", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "data", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Data", + "required": false, + "type": "ARRAY" + } ], + "required": null, + "type": "OBJECT" + }, + "placeholder": null, + "sampleOutput": { + "hasMoreResults": false, + "data": "AccountResult[]", + "code": "OK", + "message": "" + } + }, + "outputSchema": { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": null, + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { + "responseType": { + "contentType": "application/json", + "type": "JSON" + } + }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "SELECT", + "defaultValue": null, + "description": "Represents resulting code in case when the system has handled a request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Code", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "code", + "options": [ { + "description": null, + "label": "OK", + "value": "OK" + }, { + "description": null, + "label": "VALIDATION_FAILED", + "value": "VALIDATION_FAILED" + }, { + "description": null, + "label": "DATA_UNAVAILABLE", + "value": "DATA_UNAVAILABLE" + }, { + "description": null, + "label": "CONSENT_EXPIRED", + "value": "CONSENT_EXPIRED" + }, { + "description": null, + "label": "GENERAL_ERROR", + "value": "GENERAL_ERROR" + } ], + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "The error message, present only if the \"code\" property is not \"OK\".", + "displayCondition": null, + "exampleValue": "General error", + "expressionEnabled": null, + "hidden": null, + "label": "Message", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "message", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "SELECT", + "defaultValue": null, + "description": "System limits number of transactions in response. If there are more results related to the request, this flag is set to true. In that case client should initiate a new request with the value of lastTransactionId parameter set to the greatest received transaction identifier plus 1.", + "displayCondition": null, + "exampleValue": true, + "expressionEnabled": null, + "hidden": null, + "label": "Has More Results", + "metadata": { }, + "name": "hasMoreResults", + "options": [ { + "description": null, + "label": "True", + "value": true + }, { + "description": null, + "label": "False", + "value": false + } ], + "placeholder": null, + "required": false, + "type": "BOOLEAN" + }, { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of objects related to the request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "List of objects related to the request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": null, + "required": null, + "type": "OBJECT" + } ], + "label": "Data", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "data", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Data", + "required": false, + "type": "ARRAY" + } ], + "required": null, + "type": "OBJECT" + }, + "sampleOutput": { + "hasMoreResults": false, + "data": "AccountResult[]", + "code": "OK", + "message": "" + } + }, + "perform": { }, + "processErrorResponse": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Client identifier provided by the system.", + "displayCondition": null, + "exampleValue": "4181a492-97bf-48ee-b29e-d7d6860c5565", + "expressionEnabled": null, + "hidden": null, + "label": "Client Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "clientId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Unique identifier of a request (must be generated by client).", + "displayCondition": null, + "exampleValue": "17fcaa13-eb6d-467c-a757-2e669179a19e", + "expressionEnabled": null, + "hidden": null, + "label": "Request Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "requestId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "DATE_TIME", + "defaultValue": null, + "description": "Current timestamp in UTC format (must be generated by client).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Timestamp", + "metadata": { + "type": "HEADER" + }, + "name": "timestamp", + "options": null, + "optionsDataSource": null, + "placeholder": null, + "required": true, + "type": "DATE_TIME" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
", + "displayCondition": null, + "exampleValue": "ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=", + "expressionEnabled": null, + "hidden": null, + "label": "Signature", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "signature", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + } ], + "resumePerform": null, + "title": "Gets accounts for provided client id.", + "workflowNodeDescription": null + }, { + "batch": null, + "beforeResume": null, + "beforeSuspend": null, + "beforeTimeoutResume": null, + "deprecated": null, + "description": "General rules for query parameters:
  • If lastTransactionid is provided without date parameters system will not set default values for date range (only lastTransactionId will be used for data filtering).
  • Max range between dateFrom and dateTo is 7 days. If provided date range is greater, dateFrom is set to the dateTo minus 7 days.
  • If dateFrom and dateTo are not provided:
    • dateFrom is set to the current date minus 7 days
    • dateTo is set to the current date
  • If dateFrom is provided and dateTo is not provided:
    1. If dateFrom is set to future date, it is set to the current date.
    2. dateTo is set to dateFrom plus 1 day
  • If dateFrom is not provided and dateTo is provided:
    1. If dateTo is set to future date, it is set to the current date.
    2. dateFrom is set to dateTo minus 1 day
", + "help": null, + "metadata": { + "method": "GET", + "path": "/accounts/{iban}/transactions" + }, + "name": "getAccountTransactions", + "outputDefinition": { + "output": null, + "outputResponse": { + "outputSchema": { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": null, + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { + "responseType": { + "contentType": "application/json", + "type": "JSON" + } + }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "SELECT", + "defaultValue": null, + "description": "Represents resulting code in case when the system has handled a request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Code", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "code", + "options": [ { + "description": null, + "label": "OK", + "value": "OK" + }, { + "description": null, + "label": "VALIDATION_FAILED", + "value": "VALIDATION_FAILED" + }, { + "description": null, + "label": "DATA_UNAVAILABLE", + "value": "DATA_UNAVAILABLE" + }, { + "description": null, + "label": "CONSENT_EXPIRED", + "value": "CONSENT_EXPIRED" + }, { + "description": null, + "label": "GENERAL_ERROR", + "value": "GENERAL_ERROR" + } ], + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "The error message, present only if the \"code\" property is not \"OK\".", + "displayCondition": null, + "exampleValue": "General error", + "expressionEnabled": null, + "hidden": null, + "label": "Message", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "message", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "SELECT", + "defaultValue": null, + "description": "System limits number of transactions in response. If there are more results related to the request, this flag is set to true. In that case client should initiate a new request with the value of lastTransactionId parameter set to the greatest received transaction identifier plus 1.", + "displayCondition": null, + "exampleValue": true, + "expressionEnabled": null, + "hidden": null, + "label": "Has More Results", + "metadata": { }, + "name": "hasMoreResults", + "options": [ { + "description": null, + "label": "True", + "value": true + }, { + "description": null, + "label": "False", + "value": false + } ], + "placeholder": null, + "required": false, + "type": "BOOLEAN" + }, { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of objects related to the request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "List of objects related to the request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": null, + "required": null, + "type": "OBJECT" + } ], + "label": "Data", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "data", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Data", + "required": false, + "type": "ARRAY" + } ], + "required": null, + "type": "OBJECT" + }, + "placeholder": null, + "sampleOutput": { + "hasMoreResults": true, + "data": "TransactionResult[]", + "code": "OK", + "message": "" + } + }, + "outputSchema": { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": null, + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { + "responseType": { + "contentType": "application/json", + "type": "JSON" + } + }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "SELECT", + "defaultValue": null, + "description": "Represents resulting code in case when the system has handled a request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Code", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "code", + "options": [ { + "description": null, + "label": "OK", + "value": "OK" + }, { + "description": null, + "label": "VALIDATION_FAILED", + "value": "VALIDATION_FAILED" + }, { + "description": null, + "label": "DATA_UNAVAILABLE", + "value": "DATA_UNAVAILABLE" + }, { + "description": null, + "label": "CONSENT_EXPIRED", + "value": "CONSENT_EXPIRED" + }, { + "description": null, + "label": "GENERAL_ERROR", + "value": "GENERAL_ERROR" + } ], + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "The error message, present only if the \"code\" property is not \"OK\".", + "displayCondition": null, + "exampleValue": "General error", + "expressionEnabled": null, + "hidden": null, + "label": "Message", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "message", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "SELECT", + "defaultValue": null, + "description": "System limits number of transactions in response. If there are more results related to the request, this flag is set to true. In that case client should initiate a new request with the value of lastTransactionId parameter set to the greatest received transaction identifier plus 1.", + "displayCondition": null, + "exampleValue": true, + "expressionEnabled": null, + "hidden": null, + "label": "Has More Results", + "metadata": { }, + "name": "hasMoreResults", + "options": [ { + "description": null, + "label": "True", + "value": true + }, { + "description": null, + "label": "False", + "value": false + } ], + "placeholder": null, + "required": false, + "type": "BOOLEAN" + }, { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of objects related to the request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "List of objects related to the request.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": null, + "required": null, + "type": "OBJECT" + } ], + "label": "Data", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "data", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Data", + "required": false, + "type": "ARRAY" + } ], + "required": null, + "type": "OBJECT" + }, + "sampleOutput": { + "hasMoreResults": true, + "data": "TransactionResult[]", + "code": "OK", + "message": "" + } + }, + "perform": { }, + "processErrorResponse": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Client identifier provided by the system.", + "displayCondition": null, + "exampleValue": "4181a492-97bf-48ee-b29e-d7d6860c5565", + "expressionEnabled": null, + "hidden": null, + "label": "Client Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "clientId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Unique identifier of a request (must be generated by client).", + "displayCondition": null, + "exampleValue": "17fcaa13-eb6d-467c-a757-2e669179a19e", + "expressionEnabled": null, + "hidden": null, + "label": "Request Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "requestId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "DATE_TIME", + "defaultValue": null, + "description": "Current timestamp in UTC format (must be generated by client).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Timestamp", + "metadata": { + "type": "HEADER" + }, + "name": "timestamp", + "options": null, + "optionsDataSource": null, + "placeholder": null, + "required": true, + "type": "DATE_TIME" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
", + "displayCondition": null, + "exampleValue": "ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=", + "expressionEnabled": null, + "hidden": null, + "label": "Signature", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "signature", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Account IBAN.", + "displayCondition": null, + "exampleValue": "HR1210010051863000160", + "expressionEnabled": null, + "hidden": null, + "label": "Iban", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "PATH" + }, + "minLength": null, + "name": "iban", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Oldest transaction execution date.", + "displayCondition": null, + "exampleValue": "2021-01-01", + "expressionEnabled": null, + "hidden": null, + "label": "Date From", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "QUERY" + }, + "minLength": null, + "name": "dateFrom", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Newest transaction execution date.", + "displayCondition": null, + "exampleValue": "2021-01-01", + "expressionEnabled": null, + "hidden": null, + "label": "Date To", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "QUERY" + }, + "minLength": null, + "name": "dateTo", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "INTEGER", + "defaultValue": null, + "description": "If this parameter is specified, system will return transactions stored after the corresponding transaction.", + "displayCondition": null, + "exampleValue": 123, + "expressionEnabled": null, + "hidden": null, + "label": "Last Transaction Id", + "maxValue": null, + "metadata": { + "type": "QUERY" + }, + "minValue": null, + "name": "lastTransactionId", + "options": null, + "optionsDataSource": null, + "placeholder": null, + "required": false, + "type": "INTEGER" + } ], + "resumePerform": null, + "title": "Gets transactions for provided IBAN and query parameters.", + "workflowNodeDescription": null + }, { + "batch": null, + "beforeResume": null, + "beforeSuspend": null, + "beforeTimeoutResume": null, + "deprecated": null, + "description": null, + "help": null, + "metadata": { + "method": "GET", + "path": "/external-users" + }, + "name": "getExternalUsers", + "outputDefinition": { + "output": null, + "outputResponse": { + "outputSchema": { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "Standard response wrapper for all API endpoints.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { + "responseType": { + "contentType": "application/json", + "type": "JSON" + } + }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of results (empty if the response is not valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "List of results (empty if the response is not valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": null, + "required": null, + "type": "OBJECT" + } ], + "label": "Data", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "data", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Data", + "required": false, + "type": "ARRAY" + }, { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of errors (empty if the response is valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": null, + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Error code.", + "displayCondition": null, + "exampleValue": "GENERAL_ERROR", + "expressionEnabled": null, + "hidden": null, + "label": "Code", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "code", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Error description.", + "displayCondition": null, + "exampleValue": "General error", + "expressionEnabled": null, + "hidden": null, + "label": "Description", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "description", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + } ], + "required": null, + "type": "OBJECT" + } ], + "label": "Errors", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "errors", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Errors", + "required": false, + "type": "ARRAY" + } ], + "required": null, + "type": "OBJECT" + }, + "placeholder": null, + "sampleOutput": { + "data": [ { + "oib": 1.2345678901E10, + "id": 42, + "bankEntries": [ { + "bankSlug": "erste", + "ibans": [ "HR1210010051863000160" ], + "consentJobStatus": "PENDING" + } ], + "name": "Pero Perić d.o.o.", + "mail": "pero@example.com" + } ], + "errors": [ ] + } + }, + "outputSchema": { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "Standard response wrapper for all API endpoints.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { + "responseType": { + "contentType": "application/json", + "type": "JSON" + } + }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of results (empty if the response is not valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "List of results (empty if the response is not valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": null, + "required": null, + "type": "OBJECT" + } ], + "label": "Data", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "data", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Data", + "required": false, + "type": "ARRAY" + }, { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of errors (empty if the response is valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": null, + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Error code.", + "displayCondition": null, + "exampleValue": "GENERAL_ERROR", + "expressionEnabled": null, + "hidden": null, + "label": "Code", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "code", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Error description.", + "displayCondition": null, + "exampleValue": "General error", + "expressionEnabled": null, + "hidden": null, + "label": "Description", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "description", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + } ], + "required": null, + "type": "OBJECT" + } ], + "label": "Errors", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "errors", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Errors", + "required": false, + "type": "ARRAY" + } ], + "required": null, + "type": "OBJECT" + }, + "sampleOutput": { + "data": [ { + "oib": 1.2345678901E10, + "id": 42, + "bankEntries": [ { + "bankSlug": "erste", + "ibans": [ "HR1210010051863000160" ], + "consentJobStatus": "PENDING" + } ], + "name": "Pero Perić d.o.o.", + "mail": "pero@example.com" + } ], + "errors": [ ] + } + }, + "perform": { }, + "processErrorResponse": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Client identifier provided by the system.", + "displayCondition": null, + "exampleValue": "4181a492-97bf-48ee-b29e-d7d6860c5565", + "expressionEnabled": null, + "hidden": null, + "label": "Client Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "clientId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Unique identifier of a request (must be generated by client).", + "displayCondition": null, + "exampleValue": "17fcaa13-eb6d-467c-a757-2e669179a19e", + "expressionEnabled": null, + "hidden": null, + "label": "Request Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "requestId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "DATE_TIME", + "defaultValue": null, + "description": "Current timestamp in UTC format (must be generated by client).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Timestamp", + "metadata": { + "type": "HEADER" + }, + "name": "timestamp", + "options": null, + "optionsDataSource": null, + "placeholder": null, + "required": true, + "type": "DATE_TIME" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
", + "displayCondition": null, + "exampleValue": "ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=", + "expressionEnabled": null, + "hidden": null, + "label": "Signature", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "signature", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + } ], + "resumePerform": null, + "title": "Gets external users for provided client id.", + "workflowNodeDescription": null + }, { + "batch": null, + "beforeResume": null, + "beforeSuspend": null, + "beforeTimeoutResume": null, + "deprecated": null, + "description": null, + "help": null, + "metadata": { + "path": "/external-users", + "mimeType": "application/json", + "method": "POST", + "bodyContentType": "JSON" + }, + "name": "postExternalUsers", + "outputDefinition": { + "output": null, + "outputResponse": { + "outputSchema": { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "Standard response wrapper for all API endpoints.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { + "responseType": { + "contentType": "application/json", + "type": "JSON" + } + }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of results (empty if the response is not valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "List of results (empty if the response is not valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": null, + "required": null, + "type": "OBJECT" + } ], + "label": "Data", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "data", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Data", + "required": false, + "type": "ARRAY" + }, { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of errors (empty if the response is valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": null, + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Error code.", + "displayCondition": null, + "exampleValue": "GENERAL_ERROR", + "expressionEnabled": null, + "hidden": null, + "label": "Code", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "code", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Error description.", + "displayCondition": null, + "exampleValue": "General error", + "expressionEnabled": null, + "hidden": null, + "label": "Description", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "description", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + } ], + "required": null, + "type": "OBJECT" + } ], + "label": "Errors", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "errors", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Errors", + "required": false, + "type": "ARRAY" + } ], + "required": null, + "type": "OBJECT" + }, + "placeholder": null, + "sampleOutput": { + "data": [ { + "newMails": [ "new@example.com" ], + "existingMails": [ "existing@example.com" ] + } ], + "errors": [ ] + } + }, + "outputSchema": { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "Standard response wrapper for all API endpoints.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { + "responseType": { + "contentType": "application/json", + "type": "JSON" + } + }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of results (empty if the response is not valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": "List of results (empty if the response is not valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": null, + "required": null, + "type": "OBJECT" + } ], + "label": "Data", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "data", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Data", + "required": false, + "type": "ARRAY" + }, { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of errors (empty if the response is valid).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": null, + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Error code.", + "displayCondition": null, + "exampleValue": "GENERAL_ERROR", + "expressionEnabled": null, + "hidden": null, + "label": "Code", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "code", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Error description.", + "displayCondition": null, + "exampleValue": "General error", + "expressionEnabled": null, + "hidden": null, + "label": "Description", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "description", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + } ], + "required": null, + "type": "OBJECT" + } ], + "label": "Errors", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "errors", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Errors", + "required": false, + "type": "ARRAY" + } ], + "required": null, + "type": "OBJECT" + }, + "sampleOutput": { + "data": [ { + "newMails": [ "new@example.com" ], + "existingMails": [ "existing@example.com" ] + } ], + "errors": [ ] + } + }, + "perform": { }, + "processErrorResponse": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Client identifier provided by the system.", + "displayCondition": null, + "exampleValue": "4181a492-97bf-48ee-b29e-d7d6860c5565", + "expressionEnabled": null, + "hidden": null, + "label": "Client Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "clientId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Unique identifier of a request (must be generated by client).", + "displayCondition": null, + "exampleValue": "17fcaa13-eb6d-467c-a757-2e669179a19e", + "expressionEnabled": null, + "hidden": null, + "label": "Request Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "requestId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "DATE_TIME", + "defaultValue": null, + "description": "Current timestamp in UTC format (must be generated by client).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Timestamp", + "metadata": { + "type": "HEADER" + }, + "name": "timestamp", + "options": null, + "optionsDataSource": null, + "placeholder": null, + "required": true, + "type": "DATE_TIME" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
", + "displayCondition": null, + "exampleValue": "ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=", + "expressionEnabled": null, + "hidden": null, + "label": "Signature", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "signature", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": null, + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": null, + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "External user company name.", + "displayCondition": null, + "exampleValue": "Pero Perić d.o.o.", + "expressionEnabled": null, + "hidden": null, + "label": "Name", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "name", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "External user OIB (Croatian personal identification number).", + "displayCondition": null, + "exampleValue": "12345678901", + "expressionEnabled": null, + "hidden": null, + "label": "Oib", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "oib", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "External user email address.", + "displayCondition": null, + "exampleValue": "pero@example.com", + "expressionEnabled": null, + "hidden": null, + "label": "Mail", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "mail", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of bank entries to create consent jobs for.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "items": [ { + "additionalProperties": null, + "advancedOption": null, + "controlType": "OBJECT_BUILDER", + "defaultValue": null, + "description": null, + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "metadata": { }, + "multipleValues": null, + "name": null, + "options": null, + "optionsDataSource": null, + "placeholder": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Bank identifier slug.", + "displayCondition": null, + "exampleValue": "erste", + "expressionEnabled": null, + "hidden": null, + "label": "Bank Slug", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "bankSlug", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "ARRAY_BUILDER", + "defaultValue": null, + "description": "List of IBANs.", + "displayCondition": null, + "exampleValue": [ "HR1210010051863000160" ], + "expressionEnabled": null, + "hidden": null, + "items": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "List of IBANs.", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": null, + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": null, + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": null, + "type": "STRING" + } ], + "label": "Ibans", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "ibans", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Ibans", + "required": false, + "type": "ARRAY" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "PSU ID type for the bank consent.", + "displayCondition": null, + "exampleValue": "HRIdentificationNumber", + "expressionEnabled": null, + "hidden": null, + "label": "Psu Id Type", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "psuIdType", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": false, + "type": "STRING" + } ], + "required": null, + "type": "OBJECT" + } ], + "label": "Bank Entries", + "maxItems": null, + "metadata": { }, + "minItems": null, + "multipleValues": null, + "name": "bankEntries", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Bank Entries", + "required": false, + "type": "ARRAY" + } ], + "required": null, + "type": "OBJECT" + } ], + "label": "Items", + "maxItems": null, + "metadata": { + "type": "BODY" + }, + "minItems": null, + "multipleValues": null, + "name": "__items", + "options": null, + "optionsDataSource": null, + "placeholder": "Add to Items", + "required": true, + "type": "ARRAY" + } ], + "resumePerform": null, + "title": "Creates external users with bank consent jobs.", + "workflowNodeDescription": null + }, { + "batch": null, + "beforeResume": null, + "beforeSuspend": null, + "beforeTimeoutResume": null, + "deprecated": null, + "description": null, + "help": null, + "metadata": { + "method": "PUT", + "path": "/external-users/{externalUserId}" + }, + "name": "putExternalUser", + "outputDefinition": null, + "perform": { }, + "processErrorResponse": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Client identifier provided by the system.", + "displayCondition": null, + "exampleValue": "4181a492-97bf-48ee-b29e-d7d6860c5565", + "expressionEnabled": null, + "hidden": null, + "label": "Client Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "clientId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Unique identifier of a request (must be generated by client).", + "displayCondition": null, + "exampleValue": "17fcaa13-eb6d-467c-a757-2e669179a19e", + "expressionEnabled": null, + "hidden": null, + "label": "Request Id", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "requestId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "DATE_TIME", + "defaultValue": null, + "description": "Current timestamp in UTC format (must be generated by client).", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Timestamp", + "metadata": { + "type": "HEADER" + }, + "name": "timestamp", + "options": null, + "optionsDataSource": null, + "placeholder": null, + "required": true, + "type": "DATE_TIME" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "

Request signature calculated by client. Algorithm for signing is as follows:

  1. Prepare payload for signing: {clientId};{requestId};{timestamp};{uri};{body}
    • Uri example: For full URL https://example.com/MyProject/api/accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02, {uri} value used for calculation is /accounts/{IBAN}/transactions?dateFrom=2021-01-01&dateTo=2021-01-02. Note that leading slash and all query parameters must be included!
    • If request body is not present, use empty string for {body} value.
  2. Using client secret sign the payload with HmacSHA256 algorithm.
  3. Encode resulting signature in base64.
", + "displayCondition": null, + "exampleValue": "ybHjifCXXHlDNNfY8sOIK9BRoTHlxXYjusUaoN5SCp4=", + "expressionEnabled": null, + "hidden": null, + "label": "Signature", + "languageId": null, + "maxLength": null, + "metadata": { + "type": "HEADER" + }, + "minLength": null, + "name": "signature", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "INTEGER", + "defaultValue": null, + "description": "External user identifier.", + "displayCondition": null, + "exampleValue": 42, + "expressionEnabled": null, + "hidden": null, + "label": "External User Id", + "maxValue": null, + "metadata": { + "type": "PATH" + }, + "minValue": null, + "name": "externalUserId", + "options": null, + "optionsDataSource": null, + "placeholder": null, + "required": true, + "type": "INTEGER" + } ], + "resumePerform": null, + "title": "Updates an external user.", + "workflowNodeDescription": null + } ], + "clusterElements": null, + "componentCategories": null, + "connection": { + "authorizationRequired": true, + "authorizations": [ { + "acquire": null, + "apply": null, + "authorizationCallback": null, + "authorizationUrl": null, + "clientId": null, + "clientSecret": null, + "description": null, + "detectOn": null, + "name": "custom", + "oauth2AuthorizationExtraQueryParameters": null, + "pkce": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "Client Id generated at GAURUS", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Client ID", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "clientId", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "The secret key for digital signing", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Client Secret", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "clientSecret", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": true, + "type": "STRING" + }, { + "advancedOption": null, + "controlType": "SELECT", + "defaultValue": false, + "description": "Allow secure connections to servers with self-signed certificates", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Allow Self-Signed Certificates", + "metadata": { }, + "name": "allowSelfSignedCert", + "options": [ { + "description": null, + "label": "True", + "value": true + }, { + "description": null, + "label": "False", + "value": false + } ], + "placeholder": null, + "required": null, + "type": "BOOLEAN" + } ], + "refresh": null, + "refreshOn": null, + "refreshToken": null, + "refreshUrl": null, + "scopes": null, + "title": "Gaurus HmacSHA256 Authorization", + "tokenUrl": null, + "type": "CUSTOM" + } ], + "baseUri": { }, + "help": null, + "processErrorResponse": null, + "properties": [ { + "advancedOption": null, + "controlType": "TEXT", + "defaultValue": null, + "description": "The base URI of the Gaurus service", + "displayCondition": null, + "exampleValue": null, + "expressionEnabled": null, + "hidden": null, + "label": "Service URI", + "languageId": null, + "maxLength": null, + "metadata": { }, + "minLength": null, + "name": "baseUri", + "options": null, + "optionsDataSource": null, + "optionsLoadedDynamically": null, + "placeholder": null, + "regex": null, + "required": null, + "type": "STRING" + } ], + "test": null, + "version": 1 + }, + "customAction": null, + "customActionHelp": null, + "description": "Bank Connect API specification", + "icon": null, + "metadata": null, + "name": "gaurus", + "resources": null, + "tags": null, + "title": "Bank Connect", + "triggers": [ ], + "unifiedApi": null, + "version": 1 +} \ No newline at end of file From c2617f2dbb2bd3cc300955b4afc9803c88a1f97b Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Fri, 5 Jun 2026 17:30:23 +0200 Subject: [PATCH 13/16] 5137 platform - enable traceId for components via context - we want components to pass traceId to connected systems --- .../component/definition/ActionContext.java | 7 +++++ .../component/definition/ComponentDsl.java | 5 ++++ .../ai/agent/tool/AiAgentChatTool.java | 5 ++++ .../build.gradle.kts | 1 + .../component/context/ActionContextImpl.java | 30 +++++++++++++++++++ .../component/context/ContextFactoryImpl.java | 6 +++- .../definition/ActionContextAdapater.java | 5 ++++ 7 files changed, 58 insertions(+), 1 deletion(-) diff --git a/sdks/backend/java/component-api/src/main/java/com/bytechef/component/definition/ActionContext.java b/sdks/backend/java/component-api/src/main/java/com/bytechef/component/definition/ActionContext.java index 0dcfdaa842a..5715b353469 100644 --- a/sdks/backend/java/component-api/src/main/java/com/bytechef/component/definition/ActionContext.java +++ b/sdks/backend/java/component-api/src/main/java/com/bytechef/component/definition/ActionContext.java @@ -28,6 +28,13 @@ */ public interface ActionContext extends Context { + /** + * Returns trace id which originates from micro meter + * + * @return traceId + */ + String getTraceId(); + /** * @param approvalFunction */ diff --git a/sdks/backend/java/component-api/src/main/java/com/bytechef/component/definition/ComponentDsl.java b/sdks/backend/java/component-api/src/main/java/com/bytechef/component/definition/ComponentDsl.java index cee3603b918..8c42f4d8e50 100644 --- a/sdks/backend/java/component-api/src/main/java/com/bytechef/component/definition/ComponentDsl.java +++ b/sdks/backend/java/component-api/src/main/java/com/bytechef/component/definition/ComponentDsl.java @@ -4106,6 +4106,11 @@ public void suspend(Suspend suspend) { throw new UnsupportedOperationException(); } + @Override + public String getTraceId() { + throw new UnsupportedOperationException(); + } + @Override public R xml(ContextFunction xmlFunction) { return context.xml(xmlFunction); diff --git a/server/libs/modules/components/ai/agent/src/main/java/com/bytechef/component/ai/agent/tool/AiAgentChatTool.java b/server/libs/modules/components/ai/agent/src/main/java/com/bytechef/component/ai/agent/tool/AiAgentChatTool.java index 7687156eaf0..dd0f3e5f1b3 100644 --- a/server/libs/modules/components/ai/agent/src/main/java/com/bytechef/component/ai/agent/tool/AiAgentChatTool.java +++ b/server/libs/modules/components/ai/agent/src/main/java/com/bytechef/component/ai/agent/tool/AiAgentChatTool.java @@ -153,6 +153,11 @@ public void suspend(Suspend suspend) { throw new UnsupportedOperationException(); } + @Override + public String getTraceId() { + throw new UnsupportedOperationException(); + } + @Override public R xml(ContextFunction xmlFunction) { return context.xml(xmlFunction); diff --git a/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/build.gradle.kts b/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/build.gradle.kts index 2464f09763d..99cdec65702 100644 --- a/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/build.gradle.kts +++ b/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/build.gradle.kts @@ -1,4 +1,5 @@ dependencies { + implementation("io.micrometer:micrometer-tracing") implementation(libs.com.github.mizosoft.methanol) implementation("org.apache.commons:commons-lang3") implementation(libs.commons.text) diff --git a/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/src/main/java/com/bytechef/platform/component/context/ActionContextImpl.java b/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/src/main/java/com/bytechef/platform/component/context/ActionContextImpl.java index 81e0c70e6e2..5156785e94b 100644 --- a/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/src/main/java/com/bytechef/platform/component/context/ActionContextImpl.java +++ b/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/src/main/java/com/bytechef/platform/component/context/ActionContextImpl.java @@ -30,9 +30,12 @@ import com.bytechef.platform.workflow.execution.ApprovalId; import com.bytechef.platform.workflow.execution.JobResumeId; import edu.umd.cs.findbugs.annotations.SuppressFBWarnings; +import io.micrometer.tracing.TraceContext; +import io.micrometer.tracing.Tracer; import java.util.Map; import java.util.Objects; import java.util.Optional; +import java.util.UUID; import java.util.function.Consumer; import org.apache.commons.lang3.Validate; import org.jspecify.annotations.Nullable; @@ -63,6 +66,7 @@ class ActionContextImpl extends ContextImpl implements ActionContext, ActionCont private final @Nullable String publicUrl; private final long taskExecutionId; private final TempFileStorage tempFileStorage; + private final @Nullable Tracer tracer; private final @Nullable String workflowId; private final @Nullable Long environmentId; @@ -82,6 +86,7 @@ private ActionContextImpl(Builder builder) { this.logFileStorageWriter = builder.logFileStorageWriter; this.taskExecutionId = builder.taskExecutionId; this.tempFileStorage = builder.tempFileStorage; + this.tracer = builder.tracer; if (builder.jobId != null && builder.publicUrl != null) { this.approval = new ApprovalImpl(builder.jobId, builder.publicUrl); @@ -152,6 +157,7 @@ static final class Builder { private @Nullable LogFileStorageWriter logFileStorageWriter; private @Nullable String publicUrl; private long taskExecutionId; + private @Nullable Tracer tracer; private final TempFileStorage tempFileStorage; private @Nullable PlatformType type; private @Nullable String workflowId; @@ -178,6 +184,12 @@ Builder componentConnection(@Nullable ComponentConnection componentConnection) { return this; } + Builder tracer(@Nullable Tracer tracer) { + this.tracer = tracer; + + return this; + } + Builder environmentId(@Nullable Long environmentId) { this.environmentId = environmentId; @@ -237,6 +249,24 @@ ActionContextImpl build() { } } + @Override + public String getTraceId() { + if (tracer == null) { + return UUID.randomUUID() + .toString(); + } + + TraceContext context = tracer.currentTraceContext() + .context(); + + if (context == null) { + return UUID.randomUUID() + .toString(); + } + + return context.traceId(); + } + @Override public Links approval(ContextFunction approvalFunction) { try { diff --git a/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/src/main/java/com/bytechef/platform/component/context/ContextFactoryImpl.java b/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/src/main/java/com/bytechef/platform/component/context/ContextFactoryImpl.java index add3e135c96..e7ba00e84c7 100644 --- a/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/src/main/java/com/bytechef/platform/component/context/ContextFactoryImpl.java +++ b/server/libs/platform/platform-component/platform-component-context/platform-component-context-service/src/main/java/com/bytechef/platform/component/context/ContextFactoryImpl.java @@ -31,6 +31,7 @@ import com.bytechef.platform.data.storage.DataStorage; import com.bytechef.platform.file.storage.TempFileStorage; import edu.umd.cs.findbugs.annotations.SuppressFBWarnings; +import io.micrometer.tracing.Tracer; import org.jspecify.annotations.Nullable; import org.springframework.cache.CacheManager; import org.springframework.context.ApplicationContext; @@ -52,13 +53,14 @@ public class ContextFactoryImpl implements ContextFactory { private final LogFileStorage logFileStorage; private final TempFileStorage tempFileStorage; private final String publicUrl; + private final Tracer tracer; @SuppressFBWarnings("EI") public ContextFactoryImpl( ApplicationContext applicationContext, ApplicationProperties applicationProperties, CacheManager cacheManager, DataStorage dataStorage, ApplicationEventPublisher eventPublisher, FileStorageServiceRegistry fileStorageServiceRegistry, LogFileStorage logFileStorage, - TempFileStorage tempFileStorage) { + TempFileStorage tempFileStorage, Tracer tracer) { this.applicationContext = applicationContext; this.cacheManager = cacheManager; @@ -74,6 +76,7 @@ public ContextFactoryImpl( this.eventPublisher = eventPublisher; this.logFileStorage = logFileStorage; this.tempFileStorage = tempFileStorage; + this.tracer = tracer; this.publicUrl = applicationProperties.getPublicUrl(); } @@ -97,6 +100,7 @@ eventPublisher, getHttpClientExecutor(editorEnvironment), getTempFileStorage(edi .publicUrl(publicUrl) .taskExecutionId(taskExecutionId != null ? taskExecutionId : 0) .type(type) + .tracer(tracer) .workflowId(workflowId) .build(); } diff --git a/server/libs/platform/platform-component/platform-component-service/src/main/java/com/bytechef/platform/component/definition/ActionContextAdapater.java b/server/libs/platform/platform-component/platform-component-service/src/main/java/com/bytechef/platform/component/definition/ActionContextAdapater.java index 95bd2abf404..1d9be66937b 100644 --- a/server/libs/platform/platform-component/platform-component-service/src/main/java/com/bytechef/platform/component/definition/ActionContextAdapater.java +++ b/server/libs/platform/platform-component/platform-component-service/src/main/java/com/bytechef/platform/component/definition/ActionContextAdapater.java @@ -101,6 +101,11 @@ public void suspend(Suspend suspend) { throw new UnsupportedOperationException(); } + @Override + public String getTraceId() { + throw new UnsupportedOperationException(); + } + @Override public R xml(ContextFunction xmlFunction) { return context.xml(xmlFunction); From ecd1cb673a0fe0216b237729699fb27e4f043e34 Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Fri, 5 Jun 2026 18:10:32 +0200 Subject: [PATCH 14/16] 5137 components - gaurus - make sure all payload parts are aligned with specification --- .../gaurus/GaurusComponentHandler.java | 99 +++++++++++-------- 1 file changed, 60 insertions(+), 39 deletions(-) diff --git a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java index 3fab192d3b9..2b3dc56e364 100644 --- a/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java +++ b/server/libs/modules/components/gaurus/src/main/java/com/bytechef/component/gaurus/GaurusComponentHandler.java @@ -26,68 +26,80 @@ import java.nio.charset.StandardCharsets; import java.security.InvalidKeyException; import java.security.NoSuchAlgorithmException; +import java.time.Instant; +import java.time.format.DateTimeFormatter; +import java.time.temporal.ChronoUnit; import java.util.Base64; import java.util.Collections; import java.util.List; import java.util.Map; -import java.util.Objects; import java.util.Optional; import javax.crypto.Mac; import javax.crypto.spec.SecretKeySpec; -import org.apache.commons.lang3.time.DateFormatUtils; /** - * This class will not be overwritten on the subsequent calls of the generator. + * This class will not be overwritten on the repeated calls of the generator. * * @author Igor Beslic */ @AutoService(OpenApiComponentHandler.class) public class GaurusComponentHandler extends AbstractGaurusComponentHandler { + private static final String EMPTY_BODY = ""; + public ComponentDsl.ModifiableActionDefinition modifyAction(ComponentDsl.ModifiableActionDefinition modifiableActionDefinition) { - if (Objects.equals("getExternalUsers", modifiableActionDefinition.getName())) { - Optional> metadata = modifiableActionDefinition.getMetadata(); - - Map metadataMap = metadata.orElseGet(Collections::emptyMap); - - String path = (String) metadataMap.get("path"); - - modifiableActionDefinition.perform(new ActionDefinition.PerformFunction() { - @Override - public Object apply(Parameters inputParameters, Parameters connectionParameters, ActionContext context) - throws Exception { - String endpoint = - connectionParameters.getRequiredString("baseUri") + path; - - Context.Http.Executor httpExecutor = context.http(http -> http.get(endpoint)); - - String clientId = connectionParameters.getString("clientId"); - String clientSecret = connectionParameters.getString("clientSecret"); - String requestId = "SHOUD-GENERATE-0001"; - String timestamp = - DateFormatUtils.ISO_8601_EXTENDED_DATETIME_TIME_ZONE_FORMAT.format(System.currentTimeMillis()); - - Context.Http.Response response = httpExecutor - .configuration(Context.Http - .allowUnauthorizedCerts(connectionParameters.getBoolean("allowSelfSignedCert", false))) - .headers(Map.of("clienId", List.of(clientId), "requestId", - List.of(requestId), "timestamp", List.of(timestamp), - "signature", List.of(getSignature(clientId, clientSecret, requestId, timestamp, endpoint)))) - .execute(); - - return response.getBody(); - } - }); - } + + Optional> metadata = modifiableActionDefinition.getMetadata(); + + Map metadataMap = metadata.orElseGet(Collections::emptyMap); + + String path = (String) metadataMap.get("path"); + + modifiableActionDefinition.perform(new ActionDefinition.PerformFunction() { + @Override + public Object apply(Parameters inputParameters, Parameters connectionParameters, ActionContext context) + throws Exception { + String endpoint = + connectionParameters.getRequiredString("baseUri") + path; + + Context.Http.Executor httpExecutor = context.http(http -> http.get(endpoint)); + + String clientId = connectionParameters.getString("clientId"); + String clientSecret = connectionParameters.getString("clientSecret"); + String requestId = asUuid(context.getTraceId()); + String timestamp = DateTimeFormatter.ISO_INSTANT.format(Instant.now() + .truncatedTo(ChronoUnit.MILLIS)); + + String body = EMPTY_BODY; + String signature = getSignature(clientId, clientSecret, requestId, timestamp, path, body, context); + + context.log(log -> log.debug( + "Executing endpoint: {} with clientId: {}, requestId: {}, timestamp: {}, uri: {}, body: {}, signature {}", + endpoint, clientId, requestId, timestamp, path, body, signature)); + + Context.Http.Response response = httpExecutor + .configuration(Context.Http + .allowUnauthorizedCerts(connectionParameters.getBoolean("allowSelfSignedCert", false))) + .headers(Map.of("clientId", List.of(clientId), "requestId", + List.of(requestId), "timestamp", List.of(timestamp), + "signature", List.of(signature))) + .execute(); + + return response.getBody(); + } + }); return modifiableActionDefinition; } private static String getSignature( - String clientId, String clientSecret, String requestId, String timestamp, String uri) { + String clientId, String clientSecret, String requestId, String timestamp, String uri, String body, + ActionContext context) { - String forSigning = String.format("%s;%s;%s;%s;", clientId, requestId, timestamp, uri); + String forSigning = String.format("%s;%s;%s;%s;%s", clientId, requestId, timestamp, uri, body); + + context.log(log -> log.debug("Signing {} with {}", forSigning, clientSecret)); try { Mac mac = Mac.getInstance("HmacSHA256"); @@ -100,4 +112,13 @@ private static String getSignature( throw new RuntimeException("Failed to compute HmacSHA256 signature", exception); } } + + private static String asUuid(String rawUuid) { + if (rawUuid.contains("-")) { + return rawUuid; + } + + return rawUuid.replaceFirst("(\\w{8})(\\w{4})(\\w{4})(\\w{4})(\\w{12})", "$1-$2-$3-$4-$5"); + } + } From 8d66422c4576ffe38b6754f3a1ba2376adbbe7e2 Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Fri, 5 Jun 2026 18:19:30 +0200 Subject: [PATCH 15/16] 5137 components - ftp - test - update test action context implementation --- .../bytechef/component/ftp/action/BaseFtpActionIntTest.java | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/server/libs/modules/components/ftp/src/test/java/com/bytechef/component/ftp/action/BaseFtpActionIntTest.java b/server/libs/modules/components/ftp/src/test/java/com/bytechef/component/ftp/action/BaseFtpActionIntTest.java index 52834d8251c..51cc22dbb61 100644 --- a/server/libs/modules/components/ftp/src/test/java/com/bytechef/component/ftp/action/BaseFtpActionIntTest.java +++ b/server/libs/modules/components/ftp/src/test/java/com/bytechef/component/ftp/action/BaseFtpActionIntTest.java @@ -120,6 +120,11 @@ public R outputSchema(ContextFunction outputSchemaFunction) throw new UnsupportedOperationException("Disabled in test mode"); } + @Override + public String getTraceId() { + throw new UnsupportedOperationException("Disabled in test mode"); + } + @Override public R xml(ContextFunction xmlFunction) { throw new UnsupportedOperationException("Disabled in test mode"); From 6cef7a8f12addbc9e44144efe777c49ab9c3ad87 Mon Sep 17 00:00:00 2001 From: igorbeslic Date: Fri, 5 Jun 2026 18:37:16 +0200 Subject: [PATCH 16/16] 5137 platform-component - test integration - mock Micrometar Tracer --- .../platform-component-service/build.gradle.kts | 1 + .../config/ComponentDefinitionIntTestConfiguration.java | 8 ++++++++ .../platform-component-test-int-support/build.gradle.kts | 1 + .../test/config/ComponentTestIntConfiguration.java | 6 ++++++ 4 files changed, 16 insertions(+) diff --git a/server/libs/platform/platform-component/platform-component-service/build.gradle.kts b/server/libs/platform/platform-component/platform-component-service/build.gradle.kts index 18ec5bbf69c..1e1504a45ff 100644 --- a/server/libs/platform/platform-component/platform-component-service/build.gradle.kts +++ b/server/libs/platform/platform-component/platform-component-service/build.gradle.kts @@ -1,4 +1,5 @@ dependencies { + implementation(("io.micrometer:micrometer-tracing")) implementation(libs.com.github.mizosoft.methanol) implementation("org.apache.commons:commons-lang3") implementation("org.aspectj:aspectjweaver") diff --git a/server/libs/platform/platform-component/platform-component-service/src/test/java/com/bytechef/platform/component/config/ComponentDefinitionIntTestConfiguration.java b/server/libs/platform/platform-component/platform-component-service/src/test/java/com/bytechef/platform/component/config/ComponentDefinitionIntTestConfiguration.java index 322c59f8561..268c6147b09 100644 --- a/server/libs/platform/platform-component/platform-component-service/src/test/java/com/bytechef/platform/component/config/ComponentDefinitionIntTestConfiguration.java +++ b/server/libs/platform/platform-component/platform-component-service/src/test/java/com/bytechef/platform/component/config/ComponentDefinitionIntTestConfiguration.java @@ -18,7 +18,10 @@ import com.bytechef.jackson.config.JacksonConfiguration; import com.bytechef.liquibase.config.LiquibaseConfiguration; +import io.micrometer.tracing.Tracer; +import org.mockito.Mockito; import org.springframework.boot.autoconfigure.EnableAutoConfiguration; +import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.ComponentScan; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Import; @@ -34,4 +37,9 @@ @Configuration public class ComponentDefinitionIntTestConfiguration { + @Bean + Tracer tracer() { + return Mockito.mock(Tracer.class); + } + } diff --git a/server/libs/platform/platform-component/platform-component-test-int-support/build.gradle.kts b/server/libs/platform/platform-component/platform-component-test-int-support/build.gradle.kts index 0b0ad6b563f..c09cca3a8d8 100644 --- a/server/libs/platform/platform-component/platform-component-test-int-support/build.gradle.kts +++ b/server/libs/platform/platform-component/platform-component-test-int-support/build.gradle.kts @@ -1,4 +1,5 @@ dependencies { + implementation(("io.micrometer:micrometer-tracing")) implementation("org.mockito:mockito-core") implementation("org.springframework.boot:spring-boot-autoconfigure") implementation("org.springframework.boot:spring-boot-cache") diff --git a/server/libs/platform/platform-component/platform-component-test-int-support/src/main/java/com/bytechef/platform/component/test/config/ComponentTestIntConfiguration.java b/server/libs/platform/platform-component/platform-component-test-int-support/src/main/java/com/bytechef/platform/component/test/config/ComponentTestIntConfiguration.java index 19fc163e33e..ea65a276bd0 100644 --- a/server/libs/platform/platform-component/platform-component-test-int-support/src/main/java/com/bytechef/platform/component/test/config/ComponentTestIntConfiguration.java +++ b/server/libs/platform/platform-component/platform-component-test-int-support/src/main/java/com/bytechef/platform/component/test/config/ComponentTestIntConfiguration.java @@ -39,6 +39,7 @@ import com.bytechef.platform.file.storage.TempFileStorage; import com.bytechef.platform.file.storage.TempFileStorageImpl; import com.bytechef.platform.workflow.execution.accessor.JobPrincipalAccessorRegistry; +import io.micrometer.tracing.Tracer; import java.util.Collections; import java.util.List; import java.util.Map; @@ -129,6 +130,11 @@ JobPrincipalAccessorRegistry jobPrincipalAccessorRegistry() { return new JobPrincipalAccessorRegistry(List.of()); } + @Bean + Tracer tracer() { + return Mockito.mock(Tracer.class); + } + @Bean TaskFileStorage workflowFileStorageFacade() { return new TaskFileStorageImpl(new Base64FileStorageService());