@develit-services/bank 5.9.1 → 6.0.0

package/dist/base.cjs

@@ -2,7 +2,7 @@
 
 const backendSdk = require('@develit-io/backend-sdk');
 const paymentDirection = require('./shared/bank.BsWBG0gb.cjs');
-const bank = require('./shared/bank.DBTtRCcf.cjs');
+const bank = require('./shared/bank.DQZxSHKV.cjs');
 const drizzleOrm = require('drizzle-orm');
 const cloudflare_workers = require('cloudflare:workers');
 const d1 = require('drizzle-orm/d1');
@@ -107,67 +107,31 @@ async function heartbeatSyncWorkflows({
   );
 }
 
-const DISPATCH_RECOVERY_WINDOW_MS = 5 * 60 * 1e3;
-function buildDispatchInstanceId(accountId, nowMs, recoveryWindowMs = DISPATCH_RECOVERY_WINDOW_MS) {
-  return `${accountId}-${Math.floor(nowMs / recoveryWindowMs)}`;
-}
-function buildDispatchCreateOptions(instanceId, accountId, maxIterations) {
-  return {
-    id: instanceId,
-    // Omitted (not undefined) when unresolved: the workflow treats a missing
-    // budget as unbounded — degraded but syncing.
-    params: maxIterations == null ? { accountId } : { accountId, maxIterations },
-    // Dispatch mints ~24 instances per account per day and step outputs carry
-    // bank payloads — the default 30-day retention would pile up billable
-    // storage for state nobody reads after success.
-    retention: {
-      successRetention: "1 day",
-      errorRetention: "7 days"
-    }
-  };
-}
-function isAlreadyExists(err) {
-  const message = err instanceof Error ? err.message : typeof err === "object" && err !== null && "message" in err ? String(err.message) : "";
-  return /already exists/i.test(message);
-}
-
-const DEFAULT_MIN_GRACE_MS = 3 * 60 * 1e3;
 async function dispatchSyncWorkflows({
   entities,
   createInstance,
   logger,
   now = Date.now,
-  minGraceMs = DEFAULT_MIN_GRACE_MS,
-  recoveryWindowMs = DISPATCH_RECOVERY_WINDOW_MS
+  recoveryWindowMs = bank.DISPATCH_RECOVERY_WINDOW_MS
 }) {
   const at = now();
   await Promise.all(
     entities.map(async (entity) => {
       const { id, lastSyncAt } = entity;
-      const staleness = assessSyncStaleness(entity, at, minGraceMs);
-      if (staleness == null) {
+      if (!lastSyncAt) {
         logger.warn("sync-workflow.dispatch.sync-age-unknown", { id });
         return;
       }
-      if (staleness.staleForMs <= staleness.thresholdMs) return;
-      const instanceId = buildDispatchInstanceId(id, at, recoveryWindowMs);
+      const instanceId = bank.buildDispatchInstanceId(id, at, recoveryWindowMs);
       try {
         await createInstance(instanceId, id);
         logger.info("sync-workflow.dispatch.created", {
           id,
           instanceId,
-          lastSyncAt: lastSyncAt?.toISOString() ?? null,
-          staleForS: Math.round(staleness.staleForMs / 1e3),
-          thresholdS: Math.round(staleness.thresholdMs / 1e3)
+          lastSyncAt: lastSyncAt.toISOString()
         });
       } catch (err) {
-        if (isAlreadyExists(err)) {
-          logger.info("sync-workflow.dispatch.already-running", {
-            id,
-            instanceId
-          });
-          return;
-        }
+        if (bank.isAlreadyExists(err)) return;
         logger.error("sync-workflow.dispatch.failed", {
           id,
           instanceId,
@@ -1028,17 +992,14 @@ exports.BankServiceBase = class BankServiceBase extends backendSdk.develitWorker
           this.env.SYNC_DISPATCH_ACCOUNT_IDS,
           this.env.CRON_SYNC_WORKFLOW_DISPATCH
         )) {
-          const instanceId = buildDispatchInstanceId(accountId, Date.now());
-          const maxIterations = bank.parseIterationBudgetParam(
-            this.env.SYNC_WORKFLOW_MAX_ITERATIONS
-          );
+          const instanceId = bank.buildDispatchInstanceId(accountId, Date.now());
           let instance2;
           try {
             instance2 = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.create(
-              buildDispatchCreateOptions(instanceId, accountId, maxIterations)
+              bank.buildDispatchCreateOptions(instanceId, accountId)
             );
           } catch (err) {
-            if (!isAlreadyExists(err)) throw err;
+            if (!bank.isAlreadyExists(err)) throw err;
             instance2 = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(instanceId);
           }
           return {
@@ -1078,8 +1039,41 @@ exports.BankServiceBase = class BankServiceBase extends backendSdk.develitWorker
       { successMessage: "Account sync workflow restarted" },
       async ({ accountId }) => {
         await this.setSyncEnabledOrThrow(accountId, true);
-        const instance = await this.getCurrentSyncInstance(accountId);
-        await instance.restart();
+        if (isDispatchActive(
+          accountId,
+          this.env.SYNC_DISPATCH_ACCOUNT_IDS,
+          this.env.CRON_SYNC_WORKFLOW_DISPATCH
+        )) {
+          const instanceId = bank.buildDispatchInstanceId(accountId, Date.now());
+          let instance2;
+          try {
+            instance2 = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.create(
+              bank.buildDispatchCreateOptions(instanceId, accountId)
+            );
+          } catch (err) {
+            if (!bank.isAlreadyExists(err)) throw err;
+            instance2 = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(instanceId);
+            await instance2.restart();
+          }
+          return {
+            instanceId: instance2.id,
+            details: await instance2.status()
+          };
+        }
+        let instance;
+        try {
+          const existing = await this.getCurrentSyncInstance(accountId);
+          await existing.restart();
+          instance = existing;
+        } catch (err) {
+          if (!bank.isInstanceNotFound(err)) throw err;
+        }
+        if (!instance) {
+          instance = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.create({
+            id: accountId,
+            params: { accountId }
+          });
+        }
         return {
           instanceId: instance.id,
           details: await instance.status()
@@ -1417,19 +1411,10 @@ exports.BankServiceBase = class BankServiceBase extends backendSdk.develitWorker
     const selection = this.env.SYNC_DISPATCH_ACCOUNT_IDS;
     if (!selection?.trim()) return;
     const accounts = await getSyncCandidateAccountsQuery(this.db);
-    const maxIterations = bank.parseIterationBudgetParam(
-      this.env.SYNC_WORKFLOW_MAX_ITERATIONS
-    );
-    if (maxIterations == null) {
-      syncEventConsoleLogger.error(
-        "sync-workflow.dispatch.invalid-max-iterations",
-        { value: this.env.SYNC_WORKFLOW_MAX_ITERATIONS }
-      );
-    }
     await dispatchSyncWorkflows({
       entities: accounts.filter((a) => isDispatchEnabled(a.id, selection)),
       createInstance: (instanceId, accountId) => this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.create(
-        buildDispatchCreateOptions(instanceId, accountId, maxIterations)
+        bank.buildDispatchCreateOptions(instanceId, accountId)
       ),
       logger: syncEventConsoleLogger
     });

package/dist/base.mjs

@@ -1,6 +1,6 @@
 import { uuidv4, first, buildMultiFilterConditions as buildMultiFilterConditions$1, bankAccountMetadataSchema, structuredAddressSchema, workflowInstanceStatusSchema, develitWorker, createInternalError, action, service } from '@develit-io/backend-sdk';
 import { G as tables, g as accountInsertSchema, H as relations, o as isProcessedStatus, p as isTerminalStatus, L as getNonTerminalPaymentRequestsQuery, x as toIncomingPayment, N as calculateCzechIban, j as assignAccount, u as toBatchedPayment, y as toPaymentRequestInsert, a as FinbricksClient, F as FINBRICKS_ENDPOINTS } from './shared/bank.kz-PKVi5.mjs';
-import { j as encrypt, d as createCredentialsResolver, i as initiateConnector, p as parseIterationBudgetParam, e as updatePaymentRequestStatusCommand, a as getPaymentRequestsByBatchIdQuery, g as getBatchByIdQuery, u as upsertBatchCommand, b as getAccountByIdQuery, k as resolveCurrentSyncInstanceId, l as importAesKey, h as createPaymentCommand } from './shared/bank.DAjqsBQN.mjs';
+import { k as isAlreadyExists, D as DISPATCH_RECOVERY_WINDOW_MS, l as buildDispatchInstanceId, m as encrypt, d as createCredentialsResolver, i as initiateConnector, n as buildDispatchCreateOptions, o as isInstanceNotFound, e as updatePaymentRequestStatusCommand, a as getPaymentRequestsByBatchIdQuery, g as getBatchByIdQuery, u as upsertBatchCommand, b as getAccountByIdQuery, r as resolveCurrentSyncInstanceId, p as importAesKey, j as createPaymentCommand } from './shared/bank.D9DoIABz.mjs';
 import { eq, sql, and, like, asc, desc, inArray, gte, lte, isNull, count } from 'drizzle-orm';
 import { WorkerEntrypoint } from 'cloudflare:workers';
 import { drizzle } from 'drizzle-orm/d1';
@@ -105,67 +105,31 @@ async function heartbeatSyncWorkflows({
   );
 }
 
-const DISPATCH_RECOVERY_WINDOW_MS = 5 * 60 * 1e3;
-function buildDispatchInstanceId(accountId, nowMs, recoveryWindowMs = DISPATCH_RECOVERY_WINDOW_MS) {
-  return `${accountId}-${Math.floor(nowMs / recoveryWindowMs)}`;
-}
-function buildDispatchCreateOptions(instanceId, accountId, maxIterations) {
-  return {
-    id: instanceId,
-    // Omitted (not undefined) when unresolved: the workflow treats a missing
-    // budget as unbounded — degraded but syncing.
-    params: maxIterations == null ? { accountId } : { accountId, maxIterations },
-    // Dispatch mints ~24 instances per account per day and step outputs carry
-    // bank payloads — the default 30-day retention would pile up billable
-    // storage for state nobody reads after success.
-    retention: {
-      successRetention: "1 day",
-      errorRetention: "7 days"
-    }
-  };
-}
-function isAlreadyExists(err) {
-  const message = err instanceof Error ? err.message : typeof err === "object" && err !== null && "message" in err ? String(err.message) : "";
-  return /already exists/i.test(message);
-}
-
-const DEFAULT_MIN_GRACE_MS = 3 * 60 * 1e3;
 async function dispatchSyncWorkflows({
   entities,
   createInstance,
   logger,
   now = Date.now,
-  minGraceMs = DEFAULT_MIN_GRACE_MS,
   recoveryWindowMs = DISPATCH_RECOVERY_WINDOW_MS
 }) {
   const at = now();
   await Promise.all(
     entities.map(async (entity) => {
       const { id, lastSyncAt } = entity;
-      const staleness = assessSyncStaleness(entity, at, minGraceMs);
-      if (staleness == null) {
+      if (!lastSyncAt) {
         logger.warn("sync-workflow.dispatch.sync-age-unknown", { id });
         return;
       }
-      if (staleness.staleForMs <= staleness.thresholdMs) return;
       const instanceId = buildDispatchInstanceId(id, at, recoveryWindowMs);
       try {
         await createInstance(instanceId, id);
         logger.info("sync-workflow.dispatch.created", {
           id,
           instanceId,
-          lastSyncAt: lastSyncAt?.toISOString() ?? null,
-          staleForS: Math.round(staleness.staleForMs / 1e3),
-          thresholdS: Math.round(staleness.thresholdMs / 1e3)
+          lastSyncAt: lastSyncAt.toISOString()
         });
       } catch (err) {
-        if (isAlreadyExists(err)) {
-          logger.info("sync-workflow.dispatch.already-running", {
-            id,
-            instanceId
-          });
-          return;
-        }
+        if (isAlreadyExists(err)) return;
         logger.error("sync-workflow.dispatch.failed", {
           id,
           instanceId,
@@ -1027,13 +991,10 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
           this.env.CRON_SYNC_WORKFLOW_DISPATCH
         )) {
           const instanceId = buildDispatchInstanceId(accountId, Date.now());
-          const maxIterations = parseIterationBudgetParam(
-            this.env.SYNC_WORKFLOW_MAX_ITERATIONS
-          );
           let instance2;
           try {
             instance2 = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.create(
-              buildDispatchCreateOptions(instanceId, accountId, maxIterations)
+              buildDispatchCreateOptions(instanceId, accountId)
             );
           } catch (err) {
             if (!isAlreadyExists(err)) throw err;
@@ -1076,8 +1037,41 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
       { successMessage: "Account sync workflow restarted" },
       async ({ accountId }) => {
         await this.setSyncEnabledOrThrow(accountId, true);
-        const instance = await this.getCurrentSyncInstance(accountId);
-        await instance.restart();
+        if (isDispatchActive(
+          accountId,
+          this.env.SYNC_DISPATCH_ACCOUNT_IDS,
+          this.env.CRON_SYNC_WORKFLOW_DISPATCH
+        )) {
+          const instanceId = buildDispatchInstanceId(accountId, Date.now());
+          let instance2;
+          try {
+            instance2 = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.create(
+              buildDispatchCreateOptions(instanceId, accountId)
+            );
+          } catch (err) {
+            if (!isAlreadyExists(err)) throw err;
+            instance2 = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(instanceId);
+            await instance2.restart();
+          }
+          return {
+            instanceId: instance2.id,
+            details: await instance2.status()
+          };
+        }
+        let instance;
+        try {
+          const existing = await this.getCurrentSyncInstance(accountId);
+          await existing.restart();
+          instance = existing;
+        } catch (err) {
+          if (!isInstanceNotFound(err)) throw err;
+        }
+        if (!instance) {
+          instance = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.create({
+            id: accountId,
+            params: { accountId }
+          });
+        }
         return {
           instanceId: instance.id,
           details: await instance.status()
@@ -1415,19 +1409,10 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
     const selection = this.env.SYNC_DISPATCH_ACCOUNT_IDS;
     if (!selection?.trim()) return;
     const accounts = await getSyncCandidateAccountsQuery(this.db);
-    const maxIterations = parseIterationBudgetParam(
-      this.env.SYNC_WORKFLOW_MAX_ITERATIONS
-    );
-    if (maxIterations == null) {
-      syncEventConsoleLogger.error(
-        "sync-workflow.dispatch.invalid-max-iterations",
-        { value: this.env.SYNC_WORKFLOW_MAX_ITERATIONS }
-      );
-    }
     await dispatchSyncWorkflows({
       entities: accounts.filter((a) => isDispatchEnabled(a.id, selection)),
       createInstance: (instanceId, accountId) => this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.create(
-        buildDispatchCreateOptions(instanceId, accountId, maxIterations)
+        buildDispatchCreateOptions(instanceId, accountId)
       ),
       logger: syncEventConsoleLogger
     });

package/dist/export/workflows.cjs

@@ -4,7 +4,7 @@ const backendSdk = require('@develit-io/backend-sdk');
 const paymentDirection = require('../shared/bank.BsWBG0gb.cjs');
 const batchLifecycle = require('../shared/bank.NF8bZBy0.cjs');
 const drizzleOrm = require('drizzle-orm');
-const bank = require('../shared/bank.DBTtRCcf.cjs');
+const bank = require('../shared/bank.DQZxSHKV.cjs');
 const cloudflare_workers = require('cloudflare:workers');
 const cloudflare_workflows = require('cloudflare:workflows');
 const d1 = require('drizzle-orm/d1');
@@ -425,18 +425,18 @@ async function pushToQueue(queue, message) {
 }
 class BankSyncAccountPayments extends cloudflare_workers.WorkflowEntrypoint {
   async run(event, step) {
-    const { accountId, maxIterations } = event.payload;
-    const iterationBudget = bank.resolveIterationBudget(maxIterations);
+    const { accountId } = event.payload;
     const db = d1.drizzle(this.env.BANK_D1, { schema: paymentDirection.tables, relations: paymentDirection.relations });
     const logger = createWorkflowLogger(event.instanceId);
     if (!accountId) {
       throw new cloudflare_workflows.NonRetryableError(`Haven't obtained accountId to load.`);
     }
+    const deadlineMs = bank.computeWindowDeadline(event.instanceId, accountId);
     const workflowStartedAt = await step.do(
       "capture workflow start time",
       async () => Date.now()
     );
-    for (let iteration = 0; iteration < iterationBudget; iteration++) {
+    for (let iteration = 0; ; iteration++) {
       const account = await step.do("load account", async () => {
         const account2 = await bank.getAccountByIdQuery(db, { accountId });
         if (!account2) {
@@ -481,6 +481,15 @@ class BankSyncAccountPayments extends cloudflare_workers.WorkflowEntrypoint {
           isCatchUp: window.isCatchUp
         };
       });
+      if (deadlineMs != null && windowMs.dateFromMs >= deadlineMs) {
+        logger.info("sync.window-elapsed", {
+          accountId,
+          instanceId: event.instanceId,
+          iteration,
+          deadline: new Date(deadlineMs).toISOString()
+        });
+        return;
+      }
       const syncWindow = {
         dateFrom: new Date(windowMs.dateFromMs),
         dateTo: new Date(windowMs.dateToMs),
@@ -695,6 +704,12 @@ class BankSyncAccountPayments extends cloudflare_workers.WorkflowEntrypoint {
             lastSyncMetadata,
             seenInstanceId: account.lastSyncMetadata?.instanceId ?? null
           }).command;
+          if (eventsToEmit.length) {
+            await pushToQueue(
+              this.env.QUEUE_BUS_QUEUE,
+              eventsToEmit
+            );
+          }
           let syncStateRows;
           if (createCommands.length) {
             const [updateResult] = await db.batch(
@@ -710,12 +725,6 @@ class BankSyncAccountPayments extends cloudflare_workers.WorkflowEntrypoint {
               instanceId: event.instanceId
             });
           }
-          if (eventsToEmit.length) {
-            await pushToQueue(
-              this.env.QUEUE_BUS_QUEUE,
-              eventsToEmit
-            );
-          }
           return {
             ...lastSyncMetadata,
             newLastSyncAt: effectiveWindow.dateTo

package/dist/export/workflows.d.cts

@@ -9,7 +9,6 @@ declare class BankProcessBatch extends WorkflowEntrypoint<BankEnv, Params$1> {
 
 type Params = {
     accountId: string;
-    maxIterations?: number;
 };
 declare class BankSyncAccountPayments extends WorkflowEntrypoint<BankEnv, Params> {
     run(event: WorkflowEvent<Params>, step: WorkflowStep): Promise<void>;

package/dist/export/workflows.d.mts

@@ -9,7 +9,6 @@ declare class BankProcessBatch extends WorkflowEntrypoint<BankEnv, Params$1> {
 
 type Params = {
     accountId: string;
-    maxIterations?: number;
 };
 declare class BankSyncAccountPayments extends WorkflowEntrypoint<BankEnv, Params> {
     run(event: WorkflowEvent<Params>, step: WorkflowStep): Promise<void>;

package/dist/export/workflows.d.ts

@@ -9,7 +9,6 @@ declare class BankProcessBatch extends WorkflowEntrypoint<BankEnv, Params$1> {
 
 type Params = {
     accountId: string;
-    maxIterations?: number;
 };
 declare class BankSyncAccountPayments extends WorkflowEntrypoint<BankEnv, Params> {
     run(event: WorkflowEvent<Params>, step: WorkflowStep): Promise<void>;

package/dist/export/workflows.mjs

@@ -2,7 +2,7 @@ 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.kz-PKVi5.mjs';
 import { i as isBatchAuthorized, b as isBatchFailed, d as isBatchProcessing } from '../shared/bank.XqSw509X.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.DAjqsBQN.mjs';
+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 computeWindowDeadline, h as isSupersededBy, j as createPaymentCommand } from '../shared/bank.D9DoIABz.mjs';
 import { WorkflowEntrypoint } from 'cloudflare:workers';
 import { NonRetryableError } from 'cloudflare:workflows';
 import { drizzle } from 'drizzle-orm/d1';
@@ -423,18 +423,18 @@ async function pushToQueue(queue, message) {
 }
 class BankSyncAccountPayments extends WorkflowEntrypoint {
   async run(event, step) {
-    const { accountId, maxIterations } = event.payload;
-    const iterationBudget = resolveIterationBudget(maxIterations);
+    const { accountId } = event.payload;
     const db = drizzle(this.env.BANK_D1, { schema: tables, relations });
     const logger = createWorkflowLogger(event.instanceId);
     if (!accountId) {
       throw new NonRetryableError(`Haven't obtained accountId to load.`);
     }
+    const deadlineMs = computeWindowDeadline(event.instanceId, accountId);
     const workflowStartedAt = await step.do(
       "capture workflow start time",
       async () => Date.now()
     );
-    for (let iteration = 0; iteration < iterationBudget; iteration++) {
+    for (let iteration = 0; ; iteration++) {
       const account = await step.do("load account", async () => {
         const account2 = await getAccountByIdQuery(db, { accountId });
         if (!account2) {
@@ -479,6 +479,15 @@ class BankSyncAccountPayments extends WorkflowEntrypoint {
           isCatchUp: window.isCatchUp
         };
       });
+      if (deadlineMs != null && windowMs.dateFromMs >= deadlineMs) {
+        logger.info("sync.window-elapsed", {
+          accountId,
+          instanceId: event.instanceId,
+          iteration,
+          deadline: new Date(deadlineMs).toISOString()
+        });
+        return;
+      }
       const syncWindow = {
         dateFrom: new Date(windowMs.dateFromMs),
         dateTo: new Date(windowMs.dateToMs),
@@ -693,6 +702,12 @@ class BankSyncAccountPayments extends WorkflowEntrypoint {
             lastSyncMetadata,
             seenInstanceId: account.lastSyncMetadata?.instanceId ?? null
           }).command;
+          if (eventsToEmit.length) {
+            await pushToQueue(
+              this.env.QUEUE_BUS_QUEUE,
+              eventsToEmit
+            );
+          }
           let syncStateRows;
           if (createCommands.length) {
             const [updateResult] = await db.batch(
@@ -708,12 +723,6 @@ class BankSyncAccountPayments extends WorkflowEntrypoint {
               instanceId: event.instanceId
             });
           }
-          if (eventsToEmit.length) {
-            await pushToQueue(
-              this.env.QUEUE_BUS_QUEUE,
-              eventsToEmit
-            );
-          }
           return {
             ...lastSyncMetadata,
             newLastSyncAt: effectiveWindow.dateTo

package/dist/service.d.cts

@@ -19,7 +19,6 @@ interface BankServiceVariables {
     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

@@ -19,7 +19,6 @@ interface BankServiceVariables {
     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

@@ -19,7 +19,6 @@ interface BankServiceVariables {
     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.DAjqsBQN.mjs → bank.D9DoIABz.mjs}

@@ -7,6 +7,7 @@ import 'jose';
 import '@develit-io/general-codes';
 import { createHash } from 'node:crypto';
 
+const DISPATCH_RECOVERY_WINDOW_MS = 5 * 60 * 1e3;
 function parseInstanceWindow(instanceId, accountId) {
   const prefix = `${accountId}-`;
   if (!instanceId.startsWith(prefix)) return -1;
@@ -14,6 +15,37 @@ function parseInstanceWindow(instanceId, accountId) {
   if (!/^\d+$/.test(suffix)) return -1;
   return Number(suffix);
 }
+function buildDispatchInstanceId(accountId, nowMs, recoveryWindowMs = DISPATCH_RECOVERY_WINDOW_MS) {
+  return `${accountId}-${Math.floor(nowMs / recoveryWindowMs)}`;
+}
+function buildDispatchCreateOptions(instanceId, accountId) {
+  return {
+    id: instanceId,
+    params: { accountId },
+    // Dispatch mints ~24 instances per account per day and step outputs carry
+    // bank payloads — the default 30-day retention would pile up billable
+    // storage for state nobody reads after success.
+    retention: {
+      successRetention: "1 day",
+      errorRetention: "7 days"
+    }
+  };
+}
+function computeWindowDeadline(instanceId, accountId, recoveryWindowMs = DISPATCH_RECOVERY_WINDOW_MS) {
+  const window = parseInstanceWindow(instanceId, accountId);
+  if (window < 0) return null;
+  return (window + 1) * recoveryWindowMs;
+}
+function isAlreadyExists(err) {
+  return /already exists/i.test(extractMessage(err));
+}
+function isInstanceNotFound(err) {
+  return /instance.*not.?found|not.?found.*instance/i.test(extractMessage(err));
+}
+function extractMessage(err) {
+  return err instanceof Error ? err.message : typeof err === "object" && err !== null && "message" in err ? String(err.message) : "";
+}
+
 function resolveCurrentSyncInstanceId(accountId, recordedInstanceId) {
   return recordedInstanceId ?? accountId;
 }
@@ -22,18 +54,6 @@ function isSupersededBy(myInstanceId, recordedInstanceId, accountId) {
   return parseInstanceWindow(recordedInstanceId, accountId) > parseInstanceWindow(myInstanceId, accountId);
 }
 
-function normalizeBudget(value) {
-  if (!Number.isFinite(value) || value < 1) return void 0;
-  return Math.floor(value);
-}
-function parseIterationBudgetParam(value) {
-  return normalizeBudget(Number(value?.trim() || Number.NaN));
-}
-function resolveIterationBudget(maxIterations) {
-  if (maxIterations == null) return Number.POSITIVE_INFINITY;
-  return normalizeBudget(maxIterations) ?? Number.POSITIVE_INFINITY;
-}
-
 const createPaymentCommand = (db, { payment }) => {
   return {
     command: db.insert(tables.payment).values({
@@ -386,4 +406,4 @@ const initiateConnector = async ({
   }
 };
 
-export { getPaymentRequestsByBatchIdQuery as a, getAccountByIdQuery as b, checksum as c, createCredentialsResolver as d, updatePaymentRequestStatusCommand as e, isSupersededBy as f, getBatchByIdQuery as g, createPaymentCommand as h, initiateConnector as i, encrypt as j, resolveCurrentSyncInstanceId as k, importAesKey as l, parseIterationBudgetParam as p, resolveIterationBudget as r, upsertBatchCommand as u };
+export { DISPATCH_RECOVERY_WINDOW_MS as D, getPaymentRequestsByBatchIdQuery as a, getAccountByIdQuery as b, checksum as c, createCredentialsResolver as d, updatePaymentRequestStatusCommand as e, computeWindowDeadline as f, getBatchByIdQuery as g, isSupersededBy as h, initiateConnector as i, createPaymentCommand as j, isAlreadyExists as k, buildDispatchInstanceId as l, encrypt as m, buildDispatchCreateOptions as n, isInstanceNotFound as o, importAesKey as p, resolveCurrentSyncInstanceId as r, upsertBatchCommand as u };

package/dist/shared/{bank.DBTtRCcf.cjs → bank.DQZxSHKV.cjs}

@@ -9,6 +9,7 @@ require('jose');
 require('@develit-io/general-codes');
 const node_crypto = require('node:crypto');
 
+const DISPATCH_RECOVERY_WINDOW_MS = 5 * 60 * 1e3;
 function parseInstanceWindow(instanceId, accountId) {
   const prefix = `${accountId}-`;
   if (!instanceId.startsWith(prefix)) return -1;
@@ -16,6 +17,37 @@ function parseInstanceWindow(instanceId, accountId) {
   if (!/^\d+$/.test(suffix)) return -1;
   return Number(suffix);
 }
+function buildDispatchInstanceId(accountId, nowMs, recoveryWindowMs = DISPATCH_RECOVERY_WINDOW_MS) {
+  return `${accountId}-${Math.floor(nowMs / recoveryWindowMs)}`;
+}
+function buildDispatchCreateOptions(instanceId, accountId) {
+  return {
+    id: instanceId,
+    params: { accountId },
+    // Dispatch mints ~24 instances per account per day and step outputs carry
+    // bank payloads — the default 30-day retention would pile up billable
+    // storage for state nobody reads after success.
+    retention: {
+      successRetention: "1 day",
+      errorRetention: "7 days"
+    }
+  };
+}
+function computeWindowDeadline(instanceId, accountId, recoveryWindowMs = DISPATCH_RECOVERY_WINDOW_MS) {
+  const window = parseInstanceWindow(instanceId, accountId);
+  if (window < 0) return null;
+  return (window + 1) * recoveryWindowMs;
+}
+function isAlreadyExists(err) {
+  return /already exists/i.test(extractMessage(err));
+}
+function isInstanceNotFound(err) {
+  return /instance.*not.?found|not.?found.*instance/i.test(extractMessage(err));
+}
+function extractMessage(err) {
+  return err instanceof Error ? err.message : typeof err === "object" && err !== null && "message" in err ? String(err.message) : "";
+}
+
 function resolveCurrentSyncInstanceId(accountId, recordedInstanceId) {
   return recordedInstanceId ?? accountId;
 }
@@ -24,18 +56,6 @@ function isSupersededBy(myInstanceId, recordedInstanceId, accountId) {
   return parseInstanceWindow(recordedInstanceId, accountId) > parseInstanceWindow(myInstanceId, accountId);
 }
 
-function normalizeBudget(value) {
-  if (!Number.isFinite(value) || value < 1) return void 0;
-  return Math.floor(value);
-}
-function parseIterationBudgetParam(value) {
-  return normalizeBudget(Number(value?.trim() || Number.NaN));
-}
-function resolveIterationBudget(maxIterations) {
-  if (maxIterations == null) return Number.POSITIVE_INFINITY;
-  return normalizeBudget(maxIterations) ?? Number.POSITIVE_INFINITY;
-}
-
 const createPaymentCommand = (db, { payment }) => {
   return {
     command: db.insert(paymentDirection.tables.payment).values({
@@ -388,7 +408,11 @@ const initiateConnector = async ({
   }
 };
 
+exports.DISPATCH_RECOVERY_WINDOW_MS = DISPATCH_RECOVERY_WINDOW_MS;
+exports.buildDispatchCreateOptions = buildDispatchCreateOptions;
+exports.buildDispatchInstanceId = buildDispatchInstanceId;
 exports.checksum = checksum;
+exports.computeWindowDeadline = computeWindowDeadline;
 exports.createCredentialsResolver = createCredentialsResolver;
 exports.createPaymentCommand = createPaymentCommand;
 exports.encrypt = encrypt;
@@ -397,9 +421,9 @@ exports.getBatchByIdQuery = getBatchByIdQuery;
 exports.getPaymentRequestsByBatchIdQuery = getPaymentRequestsByBatchIdQuery;
 exports.importAesKey = importAesKey;
 exports.initiateConnector = initiateConnector;
+exports.isAlreadyExists = isAlreadyExists;
+exports.isInstanceNotFound = isInstanceNotFound;
 exports.isSupersededBy = isSupersededBy;
-exports.parseIterationBudgetParam = parseIterationBudgetParam;
 exports.resolveCurrentSyncInstanceId = resolveCurrentSyncInstanceId;
-exports.resolveIterationBudget = resolveIterationBudget;
 exports.updatePaymentRequestStatusCommand = updatePaymentRequestStatusCommand;
 exports.upsertBatchCommand = upsertBatchCommand;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@develit-services/bank",
-  "version": "5.9.1",
+  "version": "6.0.0",
   "author": "Develit.io s.r.o.",
   "type": "module",
   "exports": {