@develit-services/bank 5.7.1 → 5.9.0

package/dist/base.mjs

@@ -1,33 +1,49 @@
 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.BVXtqHnq.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.kz-PKVi5.mjs';
+import { j as encrypt, d as createCredentialsResolver, i as initiateConnector, b as getAccountByIdQuery, p as parseIterationBudgetParam, e as updatePaymentRequestStatusCommand, a as getPaymentRequestsByBatchIdQuery, g as getBatchByIdQuery, u as upsertBatchCommand, k as resolveCurrentSyncInstanceId, l as importAesKey, h as createPaymentCommand } from './shared/bank.DAjqsBQN.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.DLU1sOBm.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 { 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.BT7HayCV.mjs';
 import { CURRENCY_CODES } from '@develit-io/general-codes';
 import 'date-fns';
 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",
@@ -90,6 +206,26 @@ function isAlreadyFiniteError(err) {
   return /cannot_terminate|finite state/i.test(message);
 }
 
+async function disableAccountSync({
+  accountId,
+  persistDisabled,
+  terminateInstance,
+  logger
+}) {
+  await persistDisabled();
+  try {
+    const instanceId = await terminateInstance();
+    logger.info("sync-workflow.disable.terminated", { accountId, instanceId });
+    return { terminated: true, instanceId };
+  } catch (err) {
+    logger.warn("sync-workflow.disable.terminate-skipped", {
+      accountId,
+      error: err instanceof Error ? err.message : String(err)
+    });
+    return { terminated: false, instanceId: null };
+  }
+}
+
 const upsertAccountCommand = (db, { account }) => {
   const id = account.id || uuidv4();
   const { id: _id, ...accountWithoutId } = account;
@@ -177,6 +313,13 @@ const createPaymentRequestCommand = (db, { paymentRequest }) => {
   };
 };
 
+const updateAccountSyncEnabledCommand = (db, { accountId, syncEnabled }) => {
+  const command = db.update(tables.account).set({ syncEnabled }).where(eq(tables.account.id, accountId)).returning();
+  return {
+    command
+  };
+};
+
 const getAccountBatchCountsQuery = async (db, { accountId }) => {
   const result = await db.select({
     totalCount: sql`COUNT(*)`.as("totalCount"),
@@ -446,6 +589,21 @@ const getPaymentRequestsQuery = async (db, params) => {
   return { paymentRequests, totalCount };
 };
 
+const getSyncCandidateAccountsQuery = async (db) => {
+  return await db.select({
+    id: tables.account.id,
+    syncIntervalS: tables.account.syncIntervalS,
+    lastSyncAt: tables.account.lastSyncAt,
+    lastSyncMetadata: tables.account.lastSyncMetadata,
+    createdAt: tables.account.createdAt
+  }).from(tables.account).where(
+    and(
+      eq(tables.account.status, "AUTHORIZED"),
+      eq(tables.account.syncEnabled, true)
+    )
+  ).all();
+};
+
 const SIGNAL_MAP = {
   OPENED: "paymentRequestOpened",
   AUTHORIZED: "paymentRequestAuthorized",
@@ -672,7 +830,9 @@ const syncAccountTerminateInputSchema = z.object({
   accountId: z.uuid()
 });
 z.object({
-  instanceId: z.string()
+  terminated: z.boolean(),
+  // Null when the flag was persisted but no live instance existed to kill.
+  instanceId: z.string().nullable()
 });
 
 const updateAccountInputSchema = z.object({
@@ -748,6 +908,16 @@ var __decorateClass = (decorators, target, key, kind) => {
   if (kind && result) __defProp(target, key, result);
   return result;
 };
+const accountNotFoundError = () => createInternalError(null, {
+  message: "Account not found",
+  code: "DB-B-005",
+  status: 404
+});
+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 +1020,40 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
       { data: input, schema: syncAccountInputSchema },
       { successMessage: "Account sync workflow started" },
       async ({ accountId }) => {
+        const account = await getAccountByIdQuery(this.db, { accountId });
+        if (!account) {
+          throw accountNotFoundError();
+        }
+        if (!account.syncEnabled) {
+          throw createInternalError(null, {
+            message: `Account sync is disabled for ${accountId}. Enable it via restart-sync first.`,
+            code: "VALID-B-018",
+            status: 422
+          });
+        }
+        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 +1072,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 +1085,8 @@ 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);
+        await this.setSyncEnabledOrThrow(accountId, true);
+        const instance = await this.getCurrentSyncInstance(accountId);
         await instance.restart();
         return {
           instanceId: instance.id,
@@ -895,11 +1100,16 @@ 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);
-        await terminateSyncWorkflow(instance);
-        return {
-          instanceId: instance.id
-        };
+        return disableAccountSync({
+          accountId,
+          persistDisabled: () => this.setSyncEnabledOrThrow(accountId, false),
+          terminateInstance: async () => {
+            const instance = await this.getCurrentSyncInstance(accountId);
+            await terminateSyncWorkflow(instance);
+            return instance.id;
+          },
+          logger: syncEventConsoleLogger
+        });
       }
     );
   }
@@ -1179,18 +1389,61 @@ 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 setSyncEnabledOrThrow(accountId, syncEnabled) {
+    const [updated] = await updateAccountSyncEnabledCommand(this.db, {
+      accountId,
+      syncEnabled
+    }).command;
+    if (!updated) {
+      throw accountNotFoundError();
+    }
+  }
+  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 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)
+      ),
+      logger: syncEventConsoleLogger
+    });
+  }
   async heartbeatSyncWorkflows() {
-    const accounts = await this.db.select({
-      id: tables.account.id,
-      lastSyncMetadata: tables.account.lastSyncMetadata
-    }).from(tables.account).where(eq(tables.account.status, "AUTHORIZED")).all();
+    const accounts = await getSyncCandidateAccountsQuery(this.db);
     const resetAfterIterations = Number(
       this.env.SYNC_WORKFLOW_RESET_AFTER_ITERATIONS
     );
@@ -1202,9 +1455,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 +1474,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 +2233,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;
@@ -2072,14 +2335,15 @@ let BankServiceBase = class extends develitWorker(WorkerEntrypoint) {
       async ({ accountId }) => {
         const account = await getAccountByIdQuery(this.db, { accountId });
         if (!account) {
-          throw createInternalError(null, {
-            message: "Account not found",
-            code: "DB-B-005",
-            status: 404
-          });
+          throw accountNotFoundError();
         }
         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.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const database_schema = require('../shared/bank.9Yw4KHyl.cjs');
+const database_schema = require('../shared/bank.Ca3jzmIb.cjs');
 require('@develit-io/backend-sdk');
 require('drizzle-orm/sqlite-core');
 require('@develit-io/general-codes');

package/dist/database/schema.d.cts

@@ -1,4 +1,4 @@
-export { aC as account, aD as accountCredentials, aE as batch, aF as ott, aG as payment, aH as paymentRequest } from '../shared/bank.BQwwtIR4.cjs';
+export { aC as account, aD as accountCredentials, aE as batch, aF as ott, aG as payment, aH as paymentRequest } from '../shared/bank.mkq4IlpC.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 { aC as account, aD as accountCredentials, aE as batch, aF as ott, aG as payment, aH as paymentRequest } from '../shared/bank.BQwwtIR4.mjs';
+export { aC as account, aD as accountCredentials, aE as batch, aF as ott, aG as payment, aH as paymentRequest } from '../shared/bank.mkq4IlpC.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 { aC as account, aD as accountCredentials, aE as batch, aF as ott, aG as payment, aH as paymentRequest } from '../shared/bank.BQwwtIR4.js';
+export { aC as account, aD as accountCredentials, aE as batch, aF as ott, aG as payment, aH as paymentRequest } from '../shared/bank.mkq4IlpC.js';
 import 'drizzle-orm/sqlite-core';
 import 'drizzle-orm';
 import '@develit-io/general-codes';

package/dist/database/schema.mjs

@@ -1,4 +1,4 @@
-export { h as account, i as accountCredentials, j as batch, o as ott, p as payment, k as paymentRequest } from '../shared/bank.BzDNLxB_.mjs';
+export { h as account, i as accountCredentials, j as batch, o as ott, p as payment, k as paymentRequest } from '../shared/bank.BT7HayCV.mjs';
 import '@develit-io/backend-sdk';
 import 'drizzle-orm/sqlite-core';
 import '@develit-io/general-codes';