@develit-services/bank 0.8.0 → 0.8.1

package/README.md

@@ -161,6 +161,37 @@ Planovana uloha (`CRON_BATCH_STATUSES`) pravidelne vola `update-batch-statuses`,
 - Aktualizuje stavy batchu a jednotlivych plateb
 - Emituje eventy pro zmenene platby
 
+## Synchronni odeslani platby (sendPaymentSync)
+
+Alternativa k batch flow. Akce `send-payment-sync` odesle platbu **synchronne** primo do banky a vrati `authorizationUrl` pro podpis uzivatelem.
+
+```
+SendPaymentSyncInput (API vstup)
+  │
+  ▼
+  Resolve uctu (debtorIban + currency)
+  │
+  ▼
+  Inicializace konektoru
+  │
+  ▼
+  connector.initiate*Payment() (DOMESTIC/SEPA/SWIFT)
+  │
+  ▼
+  { authorizationUrl } → vraceno volajicimu
+```
+
+### Klicove rozdily oproti batch flow
+
+| | `send-payment` (batch) | `send-payment-sync` (sync) |
+|---|---|---|
+| Zpracovani | Asynchronni (queue → batch → workflow) | Synchronni (primo connector) |
+| Ulozeni do DB | Ano (payment + batch) | Ne (prijde az pres sync) |
+| Autorizacni URL | Az po `process-batch` | Ihned v response |
+| Pouziti | Hromadne platby, backoffice | Uzivatelska akce, okamzita platba |
+
+Platba se do systemu (DB) dostane az nasledne pres `syncAccountPayments` workflow, ktery periodicky stahuje transakce z banky.
+
 ## Synchronizace uctu
 
 Kazdy pripojeny ucet ma workflow `SyncAccountPayments`, ktery bezi v nekonecne smycce:
@@ -286,6 +317,7 @@ Bank service je **RPC worker** - nema vlastni verejne HTTP endpointy. Vsechny ak
 | Akce | Popis |
 |------|-------|
 | `send-payment` | Odesle platbu (vlozi do fronty pro batchovani) |
+| `send-payment-sync` | Odesle platbu synchronne primo do banky, vrati `authorizationUrl` (bez queue/batch/DB) |
 | `get-payments` | Seznam plateb s paginaci a filtry (ucet, castka, mena, smer, datum, stav) |
 | `simulate-deposit` | Testovaci: vytvori prichozi platbu ve stavu COMPLETED |
 
@@ -378,4 +410,6 @@ Format: `{CATEGORY}-B-{NUMBER}`
 | `VALID-B-001` | 400 | Invalid connector key |
 | `VALID-B-002` | 400 | One-time token expired |
 | `VALID-B-003` | 422 | Unsupported account |
+| `VALID-B-004` | 422 | No account found for single payment (IBAN + currency mismatch) |
+| `VALID-B-005` | 400 | Unsupported payment type for single payment |
 | `SYS-B-001` | 501 | Not implemented |

package/dist/export/worker.cjs

@@ -434,6 +434,8 @@ const disconnectAccountInputSchema = zod.z.object({
   accountId: zod.z.uuid()
 });
 
+const sendPaymentSyncInputSchema = sendPaymentInputSchema;
+
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __decorateClass = (decorators, target, key, kind) => {
@@ -1042,6 +1044,52 @@ let BankServiceBase = class extends backendSdk.develitWorker(cloudflare_workers.
       }
     );
   }
+  async sendPaymentSync(input) {
+    return this.handleAction(
+      { data: input, schema: sendPaymentSyncInputSchema },
+      { successMessage: "Payment initiated successfully" },
+      async (data) => {
+        const incomingPayment = mock_connector.toIncomingPayment(data);
+        const accounts = await this._getAccounts();
+        const account = accounts.find(
+          (acc) => acc.iban === incomingPayment.debtorIban && acc.currency === incomingPayment.currency
+        );
+        if (!account) {
+          throw backendSdk.createInternalError(null, {
+            message: `No account found for IBAN ${incomingPayment.debtorIban} with currency ${incomingPayment.currency}`,
+            code: "VALID-B-004",
+            status: 422
+          });
+        }
+        const batchedPayment = mock_connector.toBatchedPayment(
+          mock_connector.assignAccount(incomingPayment, account)
+        );
+        const connector = await this._initiateBankConnector({
+          connectorKey: account.connectorKey
+        });
+        const initiate = () => {
+          switch (data.paymentType) {
+            case "DOMESTIC":
+              return connector.initiateDomesticPayment(batchedPayment);
+            case "SEPA":
+              return connector.initiateSEPAPayment(batchedPayment);
+            case "SWIFT":
+              return connector.initiateForeignPayment(batchedPayment);
+            default:
+              throw backendSdk.createInternalError(null, {
+                message: `Unsupported payment type for single payment: ${data.paymentType}`,
+                code: "VALID-B-005",
+                status: 400
+              });
+          }
+        };
+        const initiated = await initiate();
+        return {
+          authorizationUrl: initiated.authorizationUrl
+        };
+      }
+    );
+  }
   async getBankAccounts(input) {
     return this.handleAction(
       { data: input, schema: getBankAccountsInputSchema },
@@ -1245,6 +1293,9 @@ __decorateClass([
 __decorateClass([
   backendSdk.action("send-payment")
 ], BankServiceBase.prototype, "sendPayment", 1);
+__decorateClass([
+  backendSdk.action("send-payment-sync")
+], BankServiceBase.prototype, "sendPaymentSync", 1);
 __decorateClass([
   backendSdk.action("get-bank-accounts")
 ], BankServiceBase.prototype, "getBankAccounts", 1);

package/dist/export/worker.d.cts

@@ -1,7 +1,7 @@
 import { A as AccountSelectType, P as PaymentSelectType, B as BatchSelectType, L as LastSyncMetadata, C as ConfigEnvironmentBank, t as tables, a as ConnectorKey, I as IBankConnector } from '../shared/bank.BJ7LqYtJ.cjs';
 import * as _develit_io_backend_sdk from '@develit-io/backend-sdk';
 import { WorkflowInstanceStatus, IRPCResponse } from '@develit-io/backend-sdk';
-import { S as SendPaymentInput, a as SendPaymentOutput } from '../shared/bank.COC0tqmL.cjs';
+import { S as SendPaymentInput, a as SendPaymentOutput, b as SendPaymentSyncInput, c as SendPaymentSyncOutput } from '../shared/bank.C0p-hLzn.cjs';
 import { WorkerEntrypoint } from 'cloudflare:workers';
 import { DrizzleD1Database } from 'drizzle-orm/d1';
 import { z } from 'zod';
@@ -1875,7 +1875,26 @@ declare class BankServiceBase extends BankServiceBase_base {
      */
     authorizeAccount(input: AuthorizeAccountInput): Promise<IRPCResponse<AuthorizeAccountOutput>>;
     simulateDeposit(input: SimulateDepositInput): Promise<IRPCResponse<SimulateDepositOutput>>;
+    /**
+     * Queues a payment for asynchronous batch processing.
+     *
+     * The payment is pushed to `PAYMENTS_READY_TO_BATCH_QUEUE` and later grouped
+     * into a batch by `addPaymentsToBatch`. The batch must then be submitted via
+     * `processBatch` to actually send it to the bank.
+     *
+     * @see {@link sendPaymentSync} for synchronous (immediate) payment submission
+     */
     sendPayment(input: SendPaymentInput): Promise<IRPCResponse<SendPaymentOutput>>;
+    /**
+     * Sends a payment synchronously directly to the bank via the connector.
+     *
+     * Unlike {@link sendPayment}, this method bypasses the queue/batch pipeline
+     * and returns the authorization URL immediately. The payment is **not** stored
+     * in the database — it will arrive later through the `syncAccountPayments` workflow.
+     *
+     * @returns Authorization URL for the user to sign the payment at the bank
+     */
+    sendPaymentSync(input: SendPaymentSyncInput): Promise<IRPCResponse<SendPaymentSyncOutput>>;
     getBankAccounts(input: GetBankAccountsInput): Promise<IRPCResponse<GetBankAccountsOutput>>;
     updateAccount(input: UpdateAccountInput): Promise<IRPCResponse<UpdateAccountOutput>>;
     disconnectAccount(input: DisconnectAccountInput): Promise<IRPCResponse<DisconnectAccountOutput>>;

package/dist/export/worker.d.mts

@@ -1,7 +1,7 @@
 import { A as AccountSelectType, P as PaymentSelectType, B as BatchSelectType, L as LastSyncMetadata, C as ConfigEnvironmentBank, t as tables, a as ConnectorKey, I as IBankConnector } from '../shared/bank.BJ7LqYtJ.mjs';
 import * as _develit_io_backend_sdk from '@develit-io/backend-sdk';
 import { WorkflowInstanceStatus, IRPCResponse } from '@develit-io/backend-sdk';
-import { S as SendPaymentInput, a as SendPaymentOutput } from '../shared/bank.COC0tqmL.mjs';
+import { S as SendPaymentInput, a as SendPaymentOutput, b as SendPaymentSyncInput, c as SendPaymentSyncOutput } from '../shared/bank.C0p-hLzn.mjs';
 import { WorkerEntrypoint } from 'cloudflare:workers';
 import { DrizzleD1Database } from 'drizzle-orm/d1';
 import { z } from 'zod';
@@ -1875,7 +1875,26 @@ declare class BankServiceBase extends BankServiceBase_base {
      */
     authorizeAccount(input: AuthorizeAccountInput): Promise<IRPCResponse<AuthorizeAccountOutput>>;
     simulateDeposit(input: SimulateDepositInput): Promise<IRPCResponse<SimulateDepositOutput>>;
+    /**
+     * Queues a payment for asynchronous batch processing.
+     *
+     * The payment is pushed to `PAYMENTS_READY_TO_BATCH_QUEUE` and later grouped
+     * into a batch by `addPaymentsToBatch`. The batch must then be submitted via
+     * `processBatch` to actually send it to the bank.
+     *
+     * @see {@link sendPaymentSync} for synchronous (immediate) payment submission
+     */
     sendPayment(input: SendPaymentInput): Promise<IRPCResponse<SendPaymentOutput>>;
+    /**
+     * Sends a payment synchronously directly to the bank via the connector.
+     *
+     * Unlike {@link sendPayment}, this method bypasses the queue/batch pipeline
+     * and returns the authorization URL immediately. The payment is **not** stored
+     * in the database — it will arrive later through the `syncAccountPayments` workflow.
+     *
+     * @returns Authorization URL for the user to sign the payment at the bank
+     */
+    sendPaymentSync(input: SendPaymentSyncInput): Promise<IRPCResponse<SendPaymentSyncOutput>>;
     getBankAccounts(input: GetBankAccountsInput): Promise<IRPCResponse<GetBankAccountsOutput>>;
     updateAccount(input: UpdateAccountInput): Promise<IRPCResponse<UpdateAccountOutput>>;
     disconnectAccount(input: DisconnectAccountInput): Promise<IRPCResponse<DisconnectAccountOutput>>;

package/dist/export/worker.d.ts

@@ -1,7 +1,7 @@
 import { A as AccountSelectType, P as PaymentSelectType, B as BatchSelectType, L as LastSyncMetadata, C as ConfigEnvironmentBank, t as tables, a as ConnectorKey, I as IBankConnector } from '../shared/bank.BJ7LqYtJ.js';
 import * as _develit_io_backend_sdk from '@develit-io/backend-sdk';
 import { WorkflowInstanceStatus, IRPCResponse } from '@develit-io/backend-sdk';
-import { S as SendPaymentInput, a as SendPaymentOutput } from '../shared/bank.COC0tqmL.js';
+import { S as SendPaymentInput, a as SendPaymentOutput, b as SendPaymentSyncInput, c as SendPaymentSyncOutput } from '../shared/bank.C0p-hLzn.js';
 import { WorkerEntrypoint } from 'cloudflare:workers';
 import { DrizzleD1Database } from 'drizzle-orm/d1';
 import { z } from 'zod';
@@ -1875,7 +1875,26 @@ declare class BankServiceBase extends BankServiceBase_base {
      */
     authorizeAccount(input: AuthorizeAccountInput): Promise<IRPCResponse<AuthorizeAccountOutput>>;
     simulateDeposit(input: SimulateDepositInput): Promise<IRPCResponse<SimulateDepositOutput>>;
+    /**
+     * Queues a payment for asynchronous batch processing.
+     *
+     * The payment is pushed to `PAYMENTS_READY_TO_BATCH_QUEUE` and later grouped
+     * into a batch by `addPaymentsToBatch`. The batch must then be submitted via
+     * `processBatch` to actually send it to the bank.
+     *
+     * @see {@link sendPaymentSync} for synchronous (immediate) payment submission
+     */
     sendPayment(input: SendPaymentInput): Promise<IRPCResponse<SendPaymentOutput>>;
+    /**
+     * Sends a payment synchronously directly to the bank via the connector.
+     *
+     * Unlike {@link sendPayment}, this method bypasses the queue/batch pipeline
+     * and returns the authorization URL immediately. The payment is **not** stored
+     * in the database — it will arrive later through the `syncAccountPayments` workflow.
+     *
+     * @returns Authorization URL for the user to sign the payment at the bank
+     */
+    sendPaymentSync(input: SendPaymentSyncInput): Promise<IRPCResponse<SendPaymentSyncOutput>>;
     getBankAccounts(input: GetBankAccountsInput): Promise<IRPCResponse<GetBankAccountsOutput>>;
     updateAccount(input: UpdateAccountInput): Promise<IRPCResponse<UpdateAccountOutput>>;
     disconnectAccount(input: DisconnectAccountInput): Promise<IRPCResponse<DisconnectAccountOutput>>;

package/dist/export/worker.mjs

@@ -432,6 +432,8 @@ const disconnectAccountInputSchema = z.object({
   accountId: z.uuid()
 });
 
+const sendPaymentSyncInputSchema = sendPaymentInputSchema;
+
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __decorateClass = (decorators, target, key, kind) => {
@@ -1040,6 +1042,52 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
       }
     );
   }
+  async sendPaymentSync(input) {
+    return this.handleAction(
+      { data: input, schema: sendPaymentSyncInputSchema },
+      { successMessage: "Payment initiated successfully" },
+      async (data) => {
+        const incomingPayment = toIncomingPayment(data);
+        const accounts = await this._getAccounts();
+        const account = accounts.find(
+          (acc) => acc.iban === incomingPayment.debtorIban && acc.currency === incomingPayment.currency
+        );
+        if (!account) {
+          throw createInternalError(null, {
+            message: `No account found for IBAN ${incomingPayment.debtorIban} with currency ${incomingPayment.currency}`,
+            code: "VALID-B-004",
+            status: 422
+          });
+        }
+        const batchedPayment = toBatchedPayment(
+          assignAccount(incomingPayment, account)
+        );
+        const connector = await this._initiateBankConnector({
+          connectorKey: account.connectorKey
+        });
+        const initiate = () => {
+          switch (data.paymentType) {
+            case "DOMESTIC":
+              return connector.initiateDomesticPayment(batchedPayment);
+            case "SEPA":
+              return connector.initiateSEPAPayment(batchedPayment);
+            case "SWIFT":
+              return connector.initiateForeignPayment(batchedPayment);
+            default:
+              throw createInternalError(null, {
+                message: `Unsupported payment type for single payment: ${data.paymentType}`,
+                code: "VALID-B-005",
+                status: 400
+              });
+          }
+        };
+        const initiated = await initiate();
+        return {
+          authorizationUrl: initiated.authorizationUrl
+        };
+      }
+    );
+  }
   async getBankAccounts(input) {
     return this.handleAction(
       { data: input, schema: getBankAccountsInputSchema },
@@ -1243,6 +1291,9 @@ __decorateClass([
 __decorateClass([
   action("send-payment")
 ], BankServiceBase.prototype, "sendPayment", 1);
+__decorateClass([
+  action("send-payment-sync")
+], BankServiceBase.prototype, "sendPaymentSync", 1);
 __decorateClass([
   action("get-bank-accounts")
 ], BankServiceBase.prototype, "getBankAccounts", 1);