@develit-services/bank 5.7.0 → 5.8.0

package/dist/base.mjs

@@ -1,10 +1,10 @@
 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.DI_Q2OtU.mjs';
+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.BVXtqHnq.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.D6gBgL07.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';
 import 'jose';
-import { h as encrypt, d as createCredentialsResolver, i as initiateConnector, e as updatePaymentRequestStatusCommand, a as getPaymentRequestsByBatchIdQuery, g as getBatchByIdQuery, u as upsertBatchCommand, j as importAesKey, f as createPaymentCommand, b as getAccountByIdQuery } from './shared/bank.BTsBHRsn.mjs';
 import { z } from 'zod';
 import { I as INSTRUCTION_PRIORITIES, C as CHARGE_BEARERS, g as PAYMENT_TYPES, b as CONNECTOR_KEYS, a as BATCH_STATUSES, f as PAYMENT_STATUSES, P as PAYMENT_DIRECTIONS, e as PAYMENT_REQUEST_STATUSES } from './shared/bank.BzDNLxB_.mjs';
 import { CURRENCY_CODES } from '@develit-io/general-codes';
@@ -13,21 +13,37 @@ import 'node:crypto';
 import 'drizzle-orm/zod';
 import 'drizzle-orm/sqlite-core';
 
+const STALE_SYNC_INTERVAL_MULTIPLIER = 3;
+function assessSyncStaleness({ syncIntervalS, lastSyncAt, createdAt }, nowMs, minGraceMs) {
+  const baseline = lastSyncAt ?? createdAt;
+  if (baseline == null) return null;
+  return {
+    staleForMs: nowMs - baseline.getTime(),
+    thresholdMs: Math.max(
+      syncIntervalS * STALE_SYNC_INTERVAL_MULTIPLIER * 1e3,
+      minGraceMs
+    )
+  };
+}
+
 const DEAD_STATUSES = /* @__PURE__ */ new Set([
   "complete",
   "terminated",
   "errored",
   "unknown"
 ]);
+const STALE_MIN_GRACE_MS = 15 * 60 * 1e3;
 async function heartbeatSyncWorkflows({
   entities,
   resetAfterIterations,
   getInstance,
   createInstance,
-  logger
+  logger,
+  now = Date.now
 }) {
   await Promise.all(
-    entities.map(async ({ id, iterationCount }) => {
+    entities.map(async (entity) => {
+      const { id, iterationCount, lastSyncAt } = entity;
       try {
         const instance = await getInstance(id);
         const { status } = await instance.status();
@@ -39,6 +55,24 @@ async function heartbeatSyncWorkflows({
           });
           return;
         }
+        const staleness = assessSyncStaleness(entity, now(), STALE_MIN_GRACE_MS);
+        if (staleness == null) {
+          logger.warn("sync-workflow.heartbeat.sync-age-unknown", {
+            id,
+            status
+          });
+        } else if (staleness.staleForMs > staleness.thresholdMs) {
+          await instance.restart();
+          logger.info("sync-workflow.heartbeat.stale-recovery", {
+            id,
+            status,
+            iterationCount,
+            lastSyncAt: lastSyncAt?.toISOString() ?? null,
+            staleForS: Math.round(staleness.staleForMs / 1e3),
+            thresholdS: Math.round(staleness.thresholdMs / 1e3)
+          });
+          return;
+        }
         if (iterationCount == null) {
           logger.warn("sync-workflow.heartbeat.iteration-count-missing", {
             id,
@@ -71,6 +105,88 @@ 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) {
+        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)
+        });
+      } catch (err) {
+        if (isAlreadyExists(err)) {
+          logger.info("sync-workflow.dispatch.already-running", {
+            id,
+            instanceId
+          });
+          return;
+        }
+        logger.error("sync-workflow.dispatch.failed", {
+          id,
+          instanceId,
+          error: err instanceof Error ? err.message : String(err)
+        });
+      }
+    })
+  );
+}
+
+function isDispatchEnabled(accountId, selection) {
+  const raw = selection?.trim();
+  if (!raw) return false;
+  if (raw.toLowerCase() === "all") return true;
+  return raw.split(",").map((id) => id.trim()).includes(accountId);
+}
+function isDispatchActive(accountId, selection, dispatchCron) {
+  if (!dispatchCron?.trim()) return false;
+  return isDispatchEnabled(accountId, selection);
+}
+
 const FINITE_STATUSES = /* @__PURE__ */ new Set([
   "complete",
   "errored",
@@ -748,6 +864,11 @@ var __decorateClass = (decorators, target, key, kind) => {
   if (kind && result) __defProp(target, key, result);
   return result;
 };
+const syncEventConsoleLogger = {
+  info: (event, data) => console.log(JSON.stringify({ level: "info", event, ...data })),
+  warn: (event, data) => console.warn(JSON.stringify({ level: "warn", event, ...data })),
+  error: (event, data) => console.error(JSON.stringify({ level: "error", event, ...data }))
+};
 let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
   constructor(ctx, env, config) {
     super(ctx, env);
@@ -850,6 +971,29 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
       { data: input, schema: syncAccountInputSchema },
       { successMessage: "Account sync workflow started" },
       async ({ accountId }) => {
+        if (isDispatchActive(
+          accountId,
+          this.env.SYNC_DISPATCH_ACCOUNT_IDS,
+          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)
+            );
+          } catch (err) {
+            if (!isAlreadyExists(err)) throw err;
+            instance2 = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(instanceId);
+          }
+          return {
+            instanceId: instance2.id,
+            details: await instance2.status()
+          };
+        }
         const instance = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.create({
           id: accountId,
           params: {
@@ -868,7 +1012,7 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
       { data: input, schema: syncAccountStatusInputSchema },
       { successMessage: "Account sync workflow status retrieved" },
       async ({ accountId }) => {
-        const instance = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(accountId);
+        const instance = await this.getCurrentSyncInstance(accountId);
         return {
           instanceId: instance.id,
           details: await instance.status()
@@ -881,7 +1025,7 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
       { data: input, schema: syncAccountRestartInputSchema },
       { successMessage: "Account sync workflow restarted" },
       async ({ accountId }) => {
-        const instance = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(accountId);
+        const instance = await this.getCurrentSyncInstance(accountId);
         await instance.restart();
         return {
           instanceId: instance.id,
@@ -895,7 +1039,7 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
       { data: input, schema: syncAccountTerminateInputSchema },
       { successMessage: "Account sync workflow terminated" },
       async ({ accountId }) => {
-        const instance = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(accountId);
+        const instance = await this.getCurrentSyncInstance(accountId);
         await terminateSyncWorkflow(instance);
         return {
           instanceId: instance.id
@@ -1179,17 +1323,62 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
     if (controller.cron === this.env.CRON_PAYMENT_STATUSES) {
       console.log("Scheduled CRON payment request statuses");
       await this.updatePaymentRequestStatuses();
-      return;
+    }
+    if (controller.cron === this.env.CRON_SYNC_WORKFLOW_DISPATCH) {
+      await this.dispatchSyncWorkflows();
     }
     if (controller.cron === this.env.CRON_SYNC_WORKFLOW_HEARTBEAT) {
       console.log("Scheduled CRON sync workflow heartbeat");
       await this.heartbeatSyncWorkflows();
     }
   }
+  /**
+   * Lifecycle actions must target the instance that actually syncs the
+   * account — under dispatch that is the windowed instance recorded with the
+   * last sync write, not the legacy canonical id.
+   */
+  async getCurrentSyncInstance(accountId) {
+    const account = await getAccountByIdQuery(this.db, { accountId });
+    return this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(
+      resolveCurrentSyncInstanceId(
+        accountId,
+        account?.lastSyncMetadata?.instanceId
+      )
+    );
+  }
+  async dispatchSyncWorkflows() {
+    const selection = this.env.SYNC_DISPATCH_ACCOUNT_IDS;
+    if (!selection?.trim()) return;
+    const accounts = await this.db.select({
+      id: tables.account.id,
+      syncIntervalS: tables.account.syncIntervalS,
+      lastSyncAt: tables.account.lastSyncAt,
+      createdAt: tables.account.createdAt
+    }).from(tables.account).where(eq(tables.account.status, "AUTHORIZED")).all();
+    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)
+      ),
+      logger: syncEventConsoleLogger
+    });
+  }
   async heartbeatSyncWorkflows() {
     const accounts = await this.db.select({
       id: tables.account.id,
-      lastSyncMetadata: tables.account.lastSyncMetadata
+      lastSyncMetadata: tables.account.lastSyncMetadata,
+      syncIntervalS: tables.account.syncIntervalS,
+      lastSyncAt: tables.account.lastSyncAt,
+      createdAt: tables.account.createdAt
     }).from(tables.account).where(eq(tables.account.status, "AUTHORIZED")).all();
     const resetAfterIterations = Number(
       this.env.SYNC_WORKFLOW_RESET_AFTER_ITERATIONS
@@ -1202,9 +1391,18 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
       return;
     }
     await heartbeatSyncWorkflows({
-      entities: accounts.map((a) => ({
+      entities: accounts.filter(
+        (a) => !isDispatchActive(
+          a.id,
+          this.env.SYNC_DISPATCH_ACCOUNT_IDS,
+          this.env.CRON_SYNC_WORKFLOW_DISPATCH
+        )
+      ).map((a) => ({
         id: a.id,
-        iterationCount: a.lastSyncMetadata?.iterationCount
+        iterationCount: a.lastSyncMetadata?.iterationCount,
+        syncIntervalS: a.syncIntervalS,
+        lastSyncAt: a.lastSyncAt,
+        createdAt: a.createdAt
       })),
       resetAfterIterations,
       getInstance: (id) => this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(id),
@@ -1212,11 +1410,7 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
         id,
         params: { accountId: id }
       }),
-      logger: {
-        info: (event, data) => console.log(JSON.stringify({ level: "info", event, ...data })),
-        warn: (event, data) => console.warn(JSON.stringify({ level: "warn", event, ...data })),
-        error: (event, data) => console.error(JSON.stringify({ level: "error", event, ...data }))
-      }
+      logger: syncEventConsoleLogger
     });
   }
   async handleAuthorizationCallback(input) {
@@ -1975,7 +2169,12 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
             if (includeWorkflow) {
               let status;
               try {
-                const instance = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(a.id);
+                const instance = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(
+                  resolveCurrentSyncInstanceId(
+                    a.id,
+                    a.lastSyncMetadata?.instanceId
+                  )
+                );
                 status = await instance.status();
               } catch (_) {
                 status = null;
@@ -2079,7 +2278,12 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
           });
         }
         try {
-          const instance = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(accountId);
+          const instance = await this.env.SYNC_ACCOUNT_PAYMENTS_WORKFLOW.get(
+            resolveCurrentSyncInstanceId(
+              accountId,
+              account.lastSyncMetadata?.instanceId
+            )
+          );
           await terminateSyncWorkflow(instance);
         } catch (error) {
           this.log({

package/dist/database/schema.d.cts

@@ -1,4 +1,4 @@
-export { aB as account, aC as accountCredentials, aD as batch, aE as ott, aF as payment, aG as paymentRequest } from '../shared/bank.DmZly4Hz.cjs';
+export { aC as account, aD as accountCredentials, aE as batch, aF as ott, aG as payment, aH as paymentRequest } from '../shared/bank.CefGTNH1.cjs';
 import 'drizzle-orm/sqlite-core';
 import 'drizzle-orm';
 import '@develit-io/general-codes';

package/dist/database/schema.d.mts

@@ -1,4 +1,4 @@
-export { aB as account, aC as accountCredentials, aD as batch, aE as ott, aF as payment, aG as paymentRequest } from '../shared/bank.DmZly4Hz.mjs';
+export { aC as account, aD as accountCredentials, aE as batch, aF as ott, aG as payment, aH as paymentRequest } from '../shared/bank.CefGTNH1.mjs';
 import 'drizzle-orm/sqlite-core';
 import 'drizzle-orm';
 import '@develit-io/general-codes';

package/dist/database/schema.d.ts

@@ -1,4 +1,4 @@
-export { aB as account, aC as accountCredentials, aD as batch, aE as ott, aF as payment, aG as paymentRequest } from '../shared/bank.DmZly4Hz.js';
+export { aC as account, aD as accountCredentials, aE as batch, aF as ott, aG as payment, aH as paymentRequest } from '../shared/bank.CefGTNH1.js';
 import 'drizzle-orm/sqlite-core';
 import 'drizzle-orm';
 import '@develit-io/general-codes';