@develit-services/bank 5.7.0 → 5.8.0

package/dist/export/workflows.mjs

@@ -1,8 +1,8 @@
 import { first, uuidv4, asNonEmpty } from '@develit-io/backend-sdk';
-import { G as tables, H as relations, v as toBatchedPaymentFromPaymentRequest, z as toPreparedPayment, m as isPaymentCompleted } from '../shared/bank.DI_Q2OtU.mjs';
+import { G as tables, H as relations, v as toBatchedPaymentFromPaymentRequest, z as toPreparedPayment, m as isPaymentCompleted } from '../shared/bank.BVXtqHnq.mjs';
 import { i as isBatchAuthorized, b as isBatchFailed, d as isBatchProcessing } from '../shared/bank.XqSw509X.mjs';
-import { eq, and, inArray } from 'drizzle-orm';
-import { g as getBatchByIdQuery, a as getPaymentRequestsByBatchIdQuery, c as checksum, u as upsertBatchCommand, b as getAccountByIdQuery, d as createCredentialsResolver, i as initiateConnector, e as updatePaymentRequestStatusCommand, f as createPaymentCommand } from '../shared/bank.BTsBHRsn.mjs';
+import { sql, and, eq, inArray } from 'drizzle-orm';
+import { g as getBatchByIdQuery, a as getPaymentRequestsByBatchIdQuery, c as checksum, u as upsertBatchCommand, b as getAccountByIdQuery, d as createCredentialsResolver, i as initiateConnector, e as updatePaymentRequestStatusCommand, f as isSupersededBy, h as createPaymentCommand, r as resolveIterationBudget } from '../shared/bank.D6gBgL07.mjs';
 import { WorkflowEntrypoint } from 'cloudflare:workers';
 import { NonRetryableError } from 'cloudflare:workflows';
 import { drizzle } from 'drizzle-orm/d1';
@@ -18,12 +18,17 @@ import 'drizzle-orm/zod';
 const updateAccountLastSyncCommand = (db, {
   lastSyncAt,
   accountId,
-  lastSyncMetadata
+  lastSyncMetadata,
+  seenInstanceId
 }) => {
+  const markerUnchanged = seenInstanceId === void 0 ? void 0 : (
+    // IS instead of = so a null marker compares equal to null.
+    sql`json_extract(${tables.account.lastSyncMetadata}, '$.instanceId') IS ${seenInstanceId}`
+  );
   const command = db.update(tables.account).set({
     lastSyncAt,
     lastSyncMetadata
-  }).where(eq(tables.account.id, accountId)).returning();
+  }).where(and(eq(tables.account.id, accountId), markerUnchanged)).returning();
   return {
     command
   };
@@ -338,6 +343,72 @@ function getStepCount(ctx) {
   return ctx.step?.count ?? 0;
 }
 
+const MAX_CATCH_UP_WINDOW_MS = 7 * 24 * 60 * 60 * 1e3;
+function resolveSyncWindow(lastSyncAt, nowMs, maxWindowMs) {
+  const openEnded = {
+    dateFrom: lastSyncAt,
+    dateTo: new Date(Math.max(nowMs, lastSyncAt.getTime())),
+    isCatchUp: false
+  };
+  if (!Number.isFinite(maxWindowMs) || maxWindowMs <= 0) return openEnded;
+  const clippedToMs = lastSyncAt.getTime() + maxWindowMs;
+  if (clippedToMs >= nowMs) return openEnded;
+  return {
+    dateFrom: lastSyncAt,
+    dateTo: new Date(clippedToMs),
+    isCatchUp: true
+  };
+}
+
+const STEP_RESULT_BYTE_CEILING = 800 * 1024;
+class StepResultTooLargeError extends NonRetryableError {
+}
+function guardStepResultSize(value, ceilingBytes = STEP_RESULT_BYTE_CEILING) {
+  const bytes = new TextEncoder().encode(JSON.stringify(value)).byteLength;
+  if (bytes > ceilingBytes) {
+    const count = Array.isArray(value) ? value.length : 1;
+    throw new StepResultTooLargeError(
+      `Fetched ${count} payments (${bytes} bytes), over the ${ceilingBytes} byte step result ceiling`
+    );
+  }
+}
+function rethrowFetchError(err) {
+  if (err instanceof NonRetryableError) throw err;
+  const message = err instanceof Error ? err.message : typeof err === "object" && err !== null && "message" in err ? String(err.message) : JSON.stringify(err);
+  throw new Error(message);
+}
+
+const MIN_CATCH_UP_WINDOW_MS = 6 * 60 * 60 * 1e3;
+async function fetchBoundedByWindow({
+  window,
+  fetchWindow,
+  guardResult,
+  minWindowMs,
+  onNarrowed
+}) {
+  let current = window;
+  while (true) {
+    const result = await fetchWindow(current);
+    try {
+      guardResult(result);
+      return { result, window: current };
+    } catch (tooLarge) {
+      if (!(tooLarge instanceof StepResultTooLargeError)) throw tooLarge;
+      const halvedSpanMs = Math.floor(
+        (current.dateTo.getTime() - current.dateFrom.getTime()) / 2
+      );
+      if (halvedSpanMs < minWindowMs) throw tooLarge;
+      current = {
+        dateFrom: current.dateFrom,
+        dateTo: new Date(current.dateFrom.getTime() + halvedSpanMs),
+        // Stops short of the original target, so another pass is needed.
+        isCatchUp: true
+      };
+      onNarrowed?.(current);
+    }
+  }
+}
+
 async function pushToQueue(queue, message) {
   if (!Array.isArray(message)) {
     await queue.send(message, { contentType: "v8" });
@@ -352,7 +423,8 @@ async function pushToQueue(queue, message) {
 }
 class BankSyncAccountPayments extends WorkflowEntrypoint {
   async run(event, step) {
-    const { accountId } = event.payload;
+    const { accountId, maxIterations } = event.payload;
+    const iterationBudget = resolveIterationBudget(maxIterations);
     const db = drizzle(this.env.BANK_D1, { schema: tables, relations });
     const logger = createWorkflowLogger(event.instanceId);
     if (!accountId) {
@@ -362,8 +434,7 @@ class BankSyncAccountPayments extends WorkflowEntrypoint {
       "capture workflow start time",
       async () => Date.now()
     );
-    while (true) {
-      const now = /* @__PURE__ */ new Date();
+    for (let iteration = 0; iteration < iterationBudget; iteration++) {
       const account = await step.do("load account", async () => {
         const account2 = await getAccountByIdQuery(db, { accountId });
         if (!account2) {
@@ -374,7 +445,38 @@ class BankSyncAccountPayments extends WorkflowEntrypoint {
       if (!account.lastSyncAt) {
         throw new Error(`lastSyncedAt is not set for account: ${accountId}`);
       }
-      const payments = await step.do(
+      if (isSupersededBy(
+        event.instanceId,
+        account.lastSyncMetadata?.instanceId,
+        accountId
+      )) {
+        logger.info("sync.superseded", {
+          accountId,
+          instanceId: event.instanceId,
+          supersededBy: account.lastSyncMetadata?.instanceId,
+          iteration
+        });
+        return;
+      }
+      const lastSyncAtMs = account.lastSyncAt.getTime();
+      const windowMs = await step.do("resolve sync window", async () => {
+        const window = resolveSyncWindow(
+          new Date(lastSyncAtMs),
+          Date.now(),
+          MAX_CATCH_UP_WINDOW_MS
+        );
+        return {
+          dateFromMs: window.dateFrom.getTime(),
+          dateToMs: window.dateTo.getTime(),
+          isCatchUp: window.isCatchUp
+        };
+      });
+      const syncWindow = {
+        dateFrom: new Date(windowMs.dateFromMs),
+        dateTo: new Date(windowMs.dateToMs),
+        isCatchUp: windowMs.isCatchUp
+      };
+      const fetched = await step.do(
         "fetch bank payments",
         {
           retries: { limit: 5, delay: "2 minutes", backoff: "exponential" },
@@ -403,42 +505,88 @@ class BankSyncAccountPayments extends WorkflowEntrypoint {
                 }
               ]
             });
-            const result = await connector.getAllAccountPayments({
-              account,
-              filter: { dateFrom: account.lastSyncAt }
-            });
+            const fetchWindow = async (window) => {
+              const result = await connector.getAllAccountPayments({
+                account,
+                filter: {
+                  dateFrom: window.dateFrom,
+                  dateTo: window.dateTo
+                }
+              });
+              const identifiable = result.filter(
+                (p) => p.parsed.bankRefId?.trim()
+              );
+              const skipped = result.length - identifiable.length;
+              if (skipped > 0) {
+                logger.warn("payments.fetch.skipped_blank_bank_ref", {
+                  accountId,
+                  connectorKey: account.connectorKey,
+                  skipped
+                });
+              }
+              return Promise.all(
+                identifiable.map(async (p) => ({
+                  parsed: {
+                    ...p.parsed,
+                    id: await deriveV4PaymentId(p.parsed)
+                  }
+                }))
+              );
+            };
+            let bounded;
+            try {
+              bounded = await fetchBoundedByWindow({
+                window: syncWindow,
+                fetchWindow,
+                guardResult: guardStepResultSize,
+                minWindowMs: MIN_CATCH_UP_WINDOW_MS,
+                onNarrowed: (narrowed) => logger.warn("payments.fetch.window-narrowed", {
+                  accountId,
+                  connectorKey: account.connectorKey,
+                  dateFrom: narrowed.dateFrom.toISOString(),
+                  dateTo: narrowed.dateTo.toISOString()
+                })
+              });
+            } catch (err) {
+              if (err instanceof StepResultTooLargeError) {
+                logger.error("payments.fetch.result-too-large", {
+                  accountId,
+                  connectorKey: account.connectorKey,
+                  dateFrom: syncWindow.dateFrom.toISOString(),
+                  dateTo: syncWindow.dateTo.toISOString()
+                });
+              }
+              throw err;
+            }
             logger.info("payments.fetch.completed", {
               accountId,
               connectorKey: account.connectorKey,
-              paymentsCount: result.length
+              paymentsCount: bounded.result.length
             });
-            const identifiable = result.filter(
-              (p) => p.parsed.bankRefId?.trim()
-            );
-            const skipped = result.length - identifiable.length;
-            if (skipped > 0) {
-              logger.warn("payments.fetch.skipped_blank_bank_ref", {
-                accountId,
-                connectorKey: account.connectorKey,
-                skipped
-              });
-            }
-            return Promise.all(
-              identifiable.map(async (p) => ({
-                parsed: { ...p.parsed, id: await deriveV4PaymentId(p.parsed) }
-              }))
-            );
+            return {
+              payments: bounded.result,
+              windowMs: {
+                dateFromMs: bounded.window.dateFrom.getTime(),
+                dateToMs: bounded.window.dateTo.getTime(),
+                isCatchUp: bounded.window.isCatchUp
+              }
+            };
           } catch (err) {
-            const message = err instanceof Error ? err.message : typeof err === "object" && err !== null && "message" in err ? String(err.message) : JSON.stringify(err);
             logger.error("payments.fetch.failed", {
               accountId,
               connectorKey: account.connectorKey,
-              error: message
+              error: err instanceof Error ? err.message : String(err)
             });
-            throw new Error(message);
+            rethrowFetchError(err);
           }
         }
       );
+      const payments = fetched.payments;
+      const effectiveWindow = {
+        dateFrom: new Date(fetched.windowMs.dateFromMs),
+        dateTo: new Date(fetched.windowMs.dateToMs),
+        isCatchUp: fetched.windowMs.isCatchUp
+      };
       const paymentsToProcess = payments.filter(
         (p) => isPaymentCompleted(p.parsed)
       );
@@ -513,6 +661,7 @@ class BankSyncAccountPayments extends WorkflowEntrypoint {
             }))
           );
           const lastSyncMetadata = {
+            instanceId: event.instanceId,
             payments: payments.length,
             paymentsToProcess: paymentsToProcess.length,
             paymentsInserted: paymentsToInsert.length,
@@ -529,15 +678,27 @@ class BankSyncAccountPayments extends WorkflowEntrypoint {
           };
           const updateLastSyncCommand = updateAccountLastSyncCommand(db, {
             accountId: account.id,
-            lastSyncAt: now,
-            lastSyncMetadata
+            // End of the window just fetched, not `now`: while catching up the
+            // window stops short of now, and advancing past it would skip every
+            // payment in the gap.
+            lastSyncAt: effectiveWindow.dateTo,
+            lastSyncMetadata,
+            seenInstanceId: account.lastSyncMetadata?.instanceId ?? null
           }).command;
+          let syncStateRows;
           if (createCommands.length) {
-            await db.batch(
+            const [updateResult] = await db.batch(
               asNonEmpty([updateLastSyncCommand, ...createCommands])
             );
+            syncStateRows = updateResult;
           } else {
-            await updateLastSyncCommand;
+            syncStateRows = await updateLastSyncCommand;
+          }
+          if (syncStateRows.length === 0) {
+            logger.info("sync.write-superseded", {
+              accountId,
+              instanceId: event.instanceId
+            });
           }
           if (eventsToEmit.length) {
             await pushToQueue(
@@ -547,14 +708,16 @@ class BankSyncAccountPayments extends WorkflowEntrypoint {
           }
           return {
             ...lastSyncMetadata,
-            newLastSyncAt: now
+            newLastSyncAt: effectiveWindow.dateTo
           };
         }
       );
-      await step.sleep(
-        "Sleep for next sync",
-        `${account.syncIntervalS} seconds`
-      );
+      if (!effectiveWindow.isCatchUp) {
+        await step.sleep(
+          "Sleep for next sync",
+          `${account.syncIntervalS} seconds`
+        );
+      }
     }
   }
 }

package/dist/service.d.cts

@@ -17,6 +17,9 @@ interface BankServiceVariables {
     DBUCS_TX_AUTH_URI: string;
     REDIRECT_URI: string;
     SYNC_WORKFLOW_RESET_AFTER_ITERATIONS: string;
+    CRON_SYNC_WORKFLOW_DISPATCH: string;
+    SYNC_DISPATCH_ACCOUNT_IDS: string;
+    SYNC_WORKFLOW_MAX_ITERATIONS: string;
     [key: string]: string | number | boolean;
 }
 declare const BANK_SERVICE_BINDINGS: {

package/dist/service.d.mts

@@ -17,6 +17,9 @@ interface BankServiceVariables {
     DBUCS_TX_AUTH_URI: string;
     REDIRECT_URI: string;
     SYNC_WORKFLOW_RESET_AFTER_ITERATIONS: string;
+    CRON_SYNC_WORKFLOW_DISPATCH: string;
+    SYNC_DISPATCH_ACCOUNT_IDS: string;
+    SYNC_WORKFLOW_MAX_ITERATIONS: string;
     [key: string]: string | number | boolean;
 }
 declare const BANK_SERVICE_BINDINGS: {

package/dist/service.d.ts

@@ -17,6 +17,9 @@ interface BankServiceVariables {
     DBUCS_TX_AUTH_URI: string;
     REDIRECT_URI: string;
     SYNC_WORKFLOW_RESET_AFTER_ITERATIONS: string;
+    CRON_SYNC_WORKFLOW_DISPATCH: string;
+    SYNC_DISPATCH_ACCOUNT_IDS: string;
+    SYNC_WORKFLOW_MAX_ITERATIONS: string;
     [key: string]: string | number | boolean;
 }
 declare const BANK_SERVICE_BINDINGS: {

package/dist/shared/{bank.0zYbe2ZB.d.ts → bank.BOeuHdjy.d.ts}

@@ -1,4 +1,4 @@
-import { e as CurrencyCode, R as BankCode, a1 as CountryCode, P as PaymentRequestSelectType } from './bank.DmZly4Hz.js';
+import { e as CurrencyCode, S as BankCode, a2 as CountryCode, P as PaymentRequestSelectType } from './bank.CefGTNH1.js';
 import { z } from 'zod';
 
 type ReferenceType = `${'VS' | 'SS' | 'KS'}:${number}`;

package/dist/shared/{bank.DI_Q2OtU.mjs → bank.BVXtqHnq.mjs}

@@ -803,6 +803,31 @@ const calculateCzechIban = (accountNumber, bankCode) => {
   return `CZ${checkDigits}${basicIban}`;
 };
 
+const unsupported = (priority, rail, supported) => {
+  throw createInternalError(null, {
+    message: `instructionPriority=${priority} is not supported on the ${rail} rail (supported: ${supported}).`,
+    code: "UNSUPPORTED_INSTRUCTION_PRIORITY",
+    status: 422
+  });
+};
+const toFinbricksPriority = (priority) => {
+  if (!priority || priority === "NORM") return "NORM";
+  if (priority === "INST") return "INST";
+  return unsupported(priority, "Finbricks SEPA/domestic", "NORM, INST");
+};
+const toFinbricksForeignPriority = (priority) => {
+  if (!priority || priority === "NORM") return "NORM";
+  return unsupported(priority, "Finbricks foreign (SWIFT)", "NORM");
+};
+const toErstePriority = (priority) => {
+  if (!priority || priority === "NORM") return "NORM";
+  if (priority === "HIGH") return "HIGH";
+  return unsupported(priority, "Erste ISO 20022", "NORM, HIGH");
+};
+const assertDbuPriority = (priority) => {
+  if (priority === "HIGH") unsupported(priority, "DBU domestic", "NORM, INST");
+};
+
 function autoVariableSymbol(paymentId) {
   let hash = 0;
   for (let i = 0; i < paymentId.length; i++) {
@@ -1090,7 +1115,7 @@ class FinbricksConnector extends IBankConnector {
             description: this.PROVIDER === "CSOB" ? composeWithUltimateCreditor(p.message, p.creditor, {
               stripDiacritics: p.currency !== "CZK"
             }) : p.message,
-            instructionPriority: p.instructionPriority ?? "NORM"
+            instructionPriority: toFinbricksPriority(p.instructionPriority)
           }))
         }
       })
@@ -1114,6 +1139,15 @@ class FinbricksConnector extends IBankConnector {
   initiateForeignBatchImpl(_args) {
     throw new Error("Finbricks: Foreign batch not implemented");
   }
+  /**
+   * endToEndIdentification for the SEPA rail. Optional per the Finbricks spec —
+   * return `undefined` to omit the field entirely, which some executing banks
+   * need because they overwrite the remittance text with it (see
+   * `CreditasConnector`).
+   */
+  buildSepaEndToEndId(payment) {
+    return this.buildEndToEndId(payment);
+  }
   async initiateForeignPayment(payment) {
     const debtorAccount = this.connectedAccounts.find(
       (acc) => acc.iban === payment.debtorIban
@@ -1171,6 +1205,9 @@ class FinbricksConnector extends IBankConnector {
           },
           ...creditorAgent && { creditorAgent },
           ...unstructured && { remittanceInformation: { unstructured } },
+          instructionPriority: toFinbricksForeignPriority(
+            payment.instructionPriority
+          ),
           callbackUrl: `${this.finbricks.REDIRECT_URI}?type=paymentRequest&paymentRequestId=${payment.id}`
         }
       })
@@ -1218,6 +1255,10 @@ class FinbricksConnector extends IBankConnector {
       0,
       140
     );
+    const endToEndIdentification = this.buildSepaEndToEndId({
+      ...payment,
+      id: payment.id
+    });
     const bankRefId = uuidv4();
     const [response, error] = await useResult(
       this.finbricks.request({
@@ -1231,10 +1272,7 @@ class FinbricksConnector extends IBankConnector {
           },
           paymentIdentification: {
             merchantTransactionId: bankRefId,
-            endToEndIdentification: this.buildEndToEndId({
-              ...payment,
-              id: payment.id
-            })
+            ...endToEndIdentification && { endToEndIdentification }
           },
           amount: payment.amount,
           debtor: {
@@ -1249,8 +1287,7 @@ class FinbricksConnector extends IBankConnector {
             ...creditorAddress && { postalAddress: creditorAddress }
           },
           remittanceInformation: { unstructured },
-          // Finbricks SEPA init accepts only NORM/INST — internal HIGH maps to NORM.
-          instructionPriority: payment.instructionPriority === "INST" ? "INST" : "NORM",
+          instructionPriority: toFinbricksPriority(payment.instructionPriority),
           callbackUrl: `${this.finbricks.REDIRECT_URI}?type=paymentRequest&paymentRequestId=${payment.id}`
         }
       })
@@ -1303,7 +1340,7 @@ class FinbricksConnector extends IBankConnector {
           // TEMP: clientId disabled per client request — do not send.
           // clientId,
           paymentProvider: this.PROVIDER,
-          instructionPriority: payment.instructionPriority ?? "NORM"
+          instructionPriority: toFinbricksPriority(payment.instructionPriority)
         }
       })
     );
@@ -1825,6 +1862,7 @@ class DbuConnector extends IBankConnector {
     };
   }
   async initiateDomesticPayment(payment) {
+    assertDbuPriority(payment.instructionPriority);
     if (payment.instructionPriority === "INST") {
       return this.initiateInstantPayment(payment);
     }
@@ -2172,7 +2210,7 @@ class ErsteConnector extends IBankConnector {
         instructionIdentification: payment.id
       },
       paymentTypeInformation: {
-        instructionPriority: payment.instructionPriority ?? "NORM"
+        instructionPriority: toErstePriority(payment.instructionPriority)
       },
       amount: {
         instructedAmount: { value: payment.amount, currency: payment.currency }

package/dist/shared/{bank.B1Xa5U2u.cjs → bank.CQjuudum.cjs}

@@ -805,6 +805,31 @@ const calculateCzechIban = (accountNumber, bankCode) => {
   return `CZ${checkDigits}${basicIban}`;
 };
 
+const unsupported = (priority, rail, supported) => {
+  throw backendSdk.createInternalError(null, {
+    message: `instructionPriority=${priority} is not supported on the ${rail} rail (supported: ${supported}).`,
+    code: "UNSUPPORTED_INSTRUCTION_PRIORITY",
+    status: 422
+  });
+};
+const toFinbricksPriority = (priority) => {
+  if (!priority || priority === "NORM") return "NORM";
+  if (priority === "INST") return "INST";
+  return unsupported(priority, "Finbricks SEPA/domestic", "NORM, INST");
+};
+const toFinbricksForeignPriority = (priority) => {
+  if (!priority || priority === "NORM") return "NORM";
+  return unsupported(priority, "Finbricks foreign (SWIFT)", "NORM");
+};
+const toErstePriority = (priority) => {
+  if (!priority || priority === "NORM") return "NORM";
+  if (priority === "HIGH") return "HIGH";
+  return unsupported(priority, "Erste ISO 20022", "NORM, HIGH");
+};
+const assertDbuPriority = (priority) => {
+  if (priority === "HIGH") unsupported(priority, "DBU domestic", "NORM, INST");
+};
+
 function autoVariableSymbol(paymentId) {
   let hash = 0;
   for (let i = 0; i < paymentId.length; i++) {
@@ -1092,7 +1117,7 @@ class FinbricksConnector extends IBankConnector {
             description: this.PROVIDER === "CSOB" ? composeWithUltimateCreditor(p.message, p.creditor, {
               stripDiacritics: p.currency !== "CZK"
             }) : p.message,
-            instructionPriority: p.instructionPriority ?? "NORM"
+            instructionPriority: toFinbricksPriority(p.instructionPriority)
           }))
         }
       })
@@ -1116,6 +1141,15 @@ class FinbricksConnector extends IBankConnector {
   initiateForeignBatchImpl(_args) {
     throw new Error("Finbricks: Foreign batch not implemented");
   }
+  /**
+   * endToEndIdentification for the SEPA rail. Optional per the Finbricks spec —
+   * return `undefined` to omit the field entirely, which some executing banks
+   * need because they overwrite the remittance text with it (see
+   * `CreditasConnector`).
+   */
+  buildSepaEndToEndId(payment) {
+    return this.buildEndToEndId(payment);
+  }
   async initiateForeignPayment(payment) {
     const debtorAccount = this.connectedAccounts.find(
       (acc) => acc.iban === payment.debtorIban
@@ -1173,6 +1207,9 @@ class FinbricksConnector extends IBankConnector {
           },
           ...creditorAgent && { creditorAgent },
           ...unstructured && { remittanceInformation: { unstructured } },
+          instructionPriority: toFinbricksForeignPriority(
+            payment.instructionPriority
+          ),
           callbackUrl: `${this.finbricks.REDIRECT_URI}?type=paymentRequest&paymentRequestId=${payment.id}`
         }
       })
@@ -1220,6 +1257,10 @@ class FinbricksConnector extends IBankConnector {
       0,
       140
     );
+    const endToEndIdentification = this.buildSepaEndToEndId({
+      ...payment,
+      id: payment.id
+    });
     const bankRefId = backendSdk.uuidv4();
     const [response, error] = await backendSdk.useResult(
       this.finbricks.request({
@@ -1233,10 +1274,7 @@ class FinbricksConnector extends IBankConnector {
           },
           paymentIdentification: {
             merchantTransactionId: bankRefId,
-            endToEndIdentification: this.buildEndToEndId({
-              ...payment,
-              id: payment.id
-            })
+            ...endToEndIdentification && { endToEndIdentification }
           },
           amount: payment.amount,
           debtor: {
@@ -1251,8 +1289,7 @@ class FinbricksConnector extends IBankConnector {
             ...creditorAddress && { postalAddress: creditorAddress }
           },
           remittanceInformation: { unstructured },
-          // Finbricks SEPA init accepts only NORM/INST — internal HIGH maps to NORM.
-          instructionPriority: payment.instructionPriority === "INST" ? "INST" : "NORM",
+          instructionPriority: toFinbricksPriority(payment.instructionPriority),
           callbackUrl: `${this.finbricks.REDIRECT_URI}?type=paymentRequest&paymentRequestId=${payment.id}`
         }
       })
@@ -1305,7 +1342,7 @@ class FinbricksConnector extends IBankConnector {
           // TEMP: clientId disabled per client request — do not send.
           // clientId,
           paymentProvider: this.PROVIDER,
-          instructionPriority: payment.instructionPriority ?? "NORM"
+          instructionPriority: toFinbricksPriority(payment.instructionPriority)
         }
       })
     );
@@ -1827,6 +1864,7 @@ class DbuConnector extends IBankConnector {
     };
   }
   async initiateDomesticPayment(payment) {
+    assertDbuPriority(payment.instructionPriority);
     if (payment.instructionPriority === "INST") {
       return this.initiateInstantPayment(payment);
     }
@@ -2174,7 +2212,7 @@ class ErsteConnector extends IBankConnector {
         instructionIdentification: payment.id
       },
       paymentTypeInformation: {
-        instructionPriority: payment.instructionPriority ?? "NORM"
+        instructionPriority: toErstePriority(payment.instructionPriority)
       },
       amount: {
         instructedAmount: { value: payment.amount, currency: payment.currency }

package/dist/shared/{bank.DmZly4Hz.d.cts → bank.CefGTNH1.d.cts}

@@ -27,6 +27,8 @@ interface LastSyncMetadata {
     eventsEmitted: number;
     iterationCount?: number;
     workflowStartedAt?: number;
+    /** Which instance wrote this sync — lets an older sibling detect it was superseded. */
+    instanceId?: string;
 }
 type ConnectorConfig = Record<string, string | number | boolean | null>;
 
@@ -3606,7 +3608,7 @@ declare const payment: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
             name: string;
             tableName: "payment";
             dataType: "string enum";
-            data: "BOOKED" | "REJECTED" | "PENDING" | "PROCESSING" | "CANCELLED" | "SCHEDULED" | "HOLD" | "INFO";
+            data: "BOOKED" | "REJECTED" | "PROCESSING" | "PENDING" | "CANCELLED" | "SCHEDULED" | "HOLD" | "INFO";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -4110,7 +4112,7 @@ declare const paymentRequest: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
             name: string;
             tableName: "payment_request";
             dataType: "string enum";
-            data: "AUTHORIZED" | "OPENED" | "COMPLETED" | "BOOKED" | "SETTLED" | "REJECTED" | "CLOSED";
+            data: "OPENED" | "AUTHORIZED" | "COMPLETED" | "BOOKED" | "SETTLED" | "REJECTED" | "CLOSED";
             driverParam: string;
             notNull: true;
             hasDefault: false;
@@ -5391,5 +5393,5 @@ type ParsedBankPayment = {
  */
 type BatchPayment = Omit<PaymentInsertType, 'bankRefId'>;
 
-export { IBankConnector as I, BASE_TERMINAL_STATUSES as M, BATCH_MODES as N, BATCH_STATUSES as O, CHARGE_BEARERS as X, CONNECTOR_KEYS as Y, COUNTRY_CODES as Z, CREDENTIALS_TYPES as _, INSTRUCTION_PRIORITIES as a3, PAYMENT_DIRECTIONS as a5, PAYMENT_REQUEST_STATUSES as a6, PAYMENT_STATUSES as a7, PAYMENT_TYPES as a8, isTerminalStatus as aA, account as aB, accountCredentials as aC, batch as aD, ott as aE, payment as aF, paymentRequest as aG, TOKEN_TYPES as ai, accountCredentialsInsertSchema as ak, accountCredentialsSelectSchema as al, accountCredentialsUpdateSchema as am, accountInsertSchema as an, accountSelectSchema as ao, accountUpdateSchema as ap, hasPaymentAccountAssigned as aq, isBatchAuthorized as ar, isBatchCompleted as as, isBatchFailed as at, isBatchInitiated as au, isBatchProcessing as av, isBatchReadyToSign as aw, isPaymentCompleted as ax, isPendingStatus as ay, isProcessedStatus as az, tables as t, ACCOUNT_STATUSES as y };
-export type { ChargeBearer as $, AccountSelectType as A, BatchSelectType as B, ConnectorConfig as C, AccountCredentialsSelectType as D, AccountCredentialsUpdateType as E, AccountPatchType as F, AccountStatus as G, HandleAuthorizationCallbackInput as H, AccountUpdateType as J, AuthorizedBatch as K, LastSyncMetadata as L, PaymentRequestSelectType as P, BankAccountWithLastSync as Q, BankCode as R, BatchInsertType as S, BatchLifecycle as T, BatchMode as U, BatchPayment as V, BatchStatus as W, PaymentSelectType as a, CompletedBatch as a0, CountryCode as a1, CredentialsType as a2, InstructionPriority as a4, PaymentDirection as a9, PaymentFailedInsertType as aa, PaymentInsertType as ab, PaymentLifecycle as ac, PaymentPreparedInsertType as ad, PaymentStatus as ae, ProcessingBatch as af, ReadyToSignBatch as ag, ResolvedCredentials as ah, TokenType as aj, ConnectorKey as b, ConfigEnvironmentBank as c, PaymentType as d, CurrencyCode as e, HandleAuthorizationCallbackOutput as f, ConnectedAccount as g, CredentialsResolver as h, AccountCredentialsInsertType as i, AccountInsertType as j, BatchedPayment as k, InitiatedBatch as l, IncomingPayment as m, InitiatedPayment as n, ParsedBankPayment as o, PaymentRequestStatus as p, AuthorizationCallbackResult as q, BatchMetadata as r, Currency as s, AccountAssignedPayment as u, PreparedPayment as v, CompletedPayment as w, PaymentRequestInsertType as x, AccountCredentialsPatchType as z };
+export { CREDENTIALS_TYPES as $, IBankConnector as I, BASE_TERMINAL_STATUSES as N, BATCH_MODES as O, BATCH_STATUSES as Q, CHARGE_BEARERS as Y, CONNECTOR_KEYS as Z, COUNTRY_CODES as _, INSTRUCTION_PRIORITIES as a4, PAYMENT_DIRECTIONS as a6, PAYMENT_REQUEST_STATUSES as a7, PAYMENT_STATUSES as a8, PAYMENT_TYPES as a9, isProcessedStatus as aA, isTerminalStatus as aB, account as aC, accountCredentials as aD, batch as aE, ott as aF, payment as aG, paymentRequest as aH, TOKEN_TYPES as aj, accountCredentialsInsertSchema as al, accountCredentialsSelectSchema as am, accountCredentialsUpdateSchema as an, accountInsertSchema as ao, accountSelectSchema as ap, accountUpdateSchema as aq, hasPaymentAccountAssigned as ar, isBatchAuthorized as as, isBatchCompleted as at, isBatchFailed as au, isBatchInitiated as av, isBatchProcessing as aw, isBatchReadyToSign as ax, isPaymentCompleted as ay, isPendingStatus as az, tables as t, ACCOUNT_STATUSES as y };
+export type { AccountSelectType as A, BatchSelectType as B, ConnectorConfig as C, AccountCredentialsSelectType as D, EndToEndIdPayment as E, AccountCredentialsUpdateType as F, AccountPatchType as G, HandleAuthorizationCallbackInput as H, AccountStatus as J, AccountUpdateType as K, LastSyncMetadata as L, AuthorizedBatch as M, PaymentRequestSelectType as P, BankAccountWithLastSync as R, BankCode as S, BatchInsertType as T, BatchLifecycle as U, BatchMode as V, BatchPayment as W, BatchStatus as X, PaymentSelectType as a, ChargeBearer as a0, CompletedBatch as a1, CountryCode as a2, CredentialsType as a3, InstructionPriority as a5, PaymentDirection as aa, PaymentFailedInsertType as ab, PaymentInsertType as ac, PaymentLifecycle as ad, PaymentPreparedInsertType as ae, PaymentStatus as af, ProcessingBatch as ag, ReadyToSignBatch as ah, ResolvedCredentials as ai, TokenType as ak, ConnectorKey as b, ConfigEnvironmentBank as c, PaymentType as d, CurrencyCode as e, HandleAuthorizationCallbackOutput as f, ConnectedAccount as g, CredentialsResolver as h, AccountCredentialsInsertType as i, AccountInsertType as j, BatchedPayment as k, InitiatedBatch as l, IncomingPayment as m, InitiatedPayment as n, ParsedBankPayment as o, PaymentRequestStatus as p, AuthorizationCallbackResult as q, BatchMetadata as r, Currency as s, AccountAssignedPayment as u, PreparedPayment as v, CompletedPayment as w, PaymentRequestInsertType as x, AccountCredentialsPatchType as z };