@bobtail.software/b-durable 1.0.5 → 1.0.7

package/dist/index.mjs

@@ -1,551 +1,91 @@
-// src/runtime/persistence.ts
-var redis;
-var blockingRedis;
-function configurePersistence(clients) {
-  if (redis || blockingRedis) {
-    console.warn(
-      "[Persistence] Los clientes de Redis ya han sido configurados. Omitiendo."
-    );
-    return;
-  }
-  redis = clients.commandClient;
-  blockingRedis = clients.blockingClient;
-}
+import{randomUUID as z}from"crypto";import q from"ioredis";var E="queue:tasks",I="durable:sleepers",R="worker:heartbeat:",k="durable:workers",x="queue:dead",L="queue:tasks:delayed";function C(i){return`workflow:${i}`}var c={RUNNING:"RUNNING",SLEEPING:"SLEEPING",COMPLETED:"COMPLETED",FAILED:"FAILED",AWAITING_SIGNAL:"AWAITING_SIGNAL",AWAITING_SUBWORKFLOW:"AWAITING_SUBWORKFLOW",CANCELLING:"CANCELLING",CANCELLED:"CANCELLED",VERSION_MISMATCH:"VERSION_MISMATCH"};var l,y;function N(i){if(l||y){console.warn("[Persistence] Los clientes de Redis ya han sido configurados. Omitiendo.");return}l=i.commandClient,y=i.blockingClient}import{randomUUID as W}from"crypto";import v from"ms";import{resolve as V}from"path";var S=class extends Error{isCancellation=!0;constructor(t){super(t),this.name="WorkflowCancellationError"}};var P=`
+if redis.call("get", KEYS[1]) == ARGV[1] then
+    return redis.call("del", KEYS[1])
+else
+    return 0
+end
+`,D=`
+if redis.call("get", KEYS[1]) == ARGV[1] then
+    return redis.call("expire", KEYS[1], ARGV[2])
+else
+    return 0
+end
+`,A=`
+local lockKey = KEYS[1]
+local workflowKey = KEYS[2]
+local token = ARGV[1]
+local state = ARGV[2]
+local updatedAt = ARGV[3]
+local step = ARGV[4]
 
-// src/runtime/runtime.ts
-import { randomUUID } from "crypto";
-import ms from "ms";
-import { resolve } from "path";
+if redis.call("get", lockKey) == token then
+    redis.call("hset", workflowKey, "state", state, "updatedAt", updatedAt, "step", step)
+    return 1
+else
+    return 0
+end
+`,_=`
+local lockKey = KEYS[1]
+local workflowKey = KEYS[2]
+local token = ARGV[1]
 
-// src/runtime/constants.ts
-var TASK_QUEUE_KEY = "queue:tasks";
-var SLEEPERS_KEY = "durable:sleepers";
-var WorkflowStatus = {
-  RUNNING: "RUNNING",
-  SLEEPING: "SLEEPING",
-  COMPLETED: "COMPLETED",
-  FAILED: "FAILED",
-  AWAITING_EVENT: "AWAITING_EVENT",
-  AWAITING_SUBWORKFLOW: "AWAITING_SUBWORKFLOW"
-};
+if redis.call("get", lockKey) == token then
+    return redis.call("hincrby", workflowKey, "step", 1)
+else
+    return -1
+end
+`,F=`
+local lockKey = KEYS[1]
+local workflowKey = KEYS[2]
+local token = ARGV[1]
+local result = ARGV[2]
+local status = ARGV[3]
 
-// src/runtime/runtime.ts
-var WorkflowRepository = class {
-  getKey(workflowId) {
-    return `workflow:${workflowId}`;
-  }
-  getLockKey(workflowId) {
-    return `workflow:${workflowId}:lock`;
-  }
-  async acquireLock(workflowId, lockTimeoutSeconds = 10) {
-    const lockKey = this.getLockKey(workflowId);
-    const result = await redis.set(lockKey, "locked", "EX", lockTimeoutSeconds, "NX");
-    return result === "OK";
-  }
-  async releaseLock(workflowId) {
-    await redis.del(this.getLockKey(workflowId));
-  }
-  async get(workflowId) {
-    const data = await redis.hgetall(this.getKey(workflowId));
-    if (!data || Object.keys(data).length === 0) {
-      return null;
-    }
-    return {
-      workflowId: data.workflowId,
-      name: data.name,
-      status: data.status,
-      step: parseInt(data.step, 10),
-      input: JSON.parse(data.input),
-      state: JSON.parse(data.state),
-      result: data.result ? JSON.parse(data.result) : void 0,
-      error: data.error,
-      parentId: data.parentId,
-      subWorkflowId: data.subWorkflowId,
-      awaitingEvent: data.awaitingEvent
-    };
-  }
-  async create(instanceData) {
-    const instance = {
-      ...instanceData,
-      step: 0,
-      state: {}
-    };
-    const pipeline = redis.pipeline();
-    pipeline.hset(this.getKey(instance.workflowId), {
-      ...instance,
-      input: JSON.stringify(instance.input),
-      state: JSON.stringify(instance.state)
-    });
-    await pipeline.exec();
-  }
-  async updateState(workflowId, state) {
-    await redis.hset(this.getKey(workflowId), "state", JSON.stringify(state));
-  }
-  async updateStatus(workflowId, status, extraFields = {}) {
-    await redis.hset(this.getKey(workflowId), { status, ...extraFields });
-  }
-  async incrementStep(workflowId) {
-    return redis.hincrby(this.getKey(workflowId), "step", 1);
-  }
-  async complete(workflowId, result) {
-    await redis.hset(this.getKey(workflowId), {
-      status: WorkflowStatus.COMPLETED,
-      result: JSON.stringify(result ?? null)
-    });
-  }
-  async fail(workflowId, error) {
-    await redis.hset(this.getKey(workflowId), {
-      status: WorkflowStatus.FAILED,
-      error: error.message
-    });
-  }
-  // --- Métodos para operaciones de Runtime ---
-  async scheduleSleep(workflowId, wakeUpAt) {
-    await this.updateStatus(workflowId, WorkflowStatus.SLEEPING);
-    await redis.zadd(SLEEPERS_KEY, wakeUpAt, workflowId);
-  }
-  async getWorkflowsToWake() {
-    const now = Date.now();
-    const ids = await redis.zrangebyscore(SLEEPERS_KEY, 0, now);
-    if (ids.length > 0) {
-      await redis.zrem(SLEEPERS_KEY, ...ids);
-    }
-    return ids;
-  }
-  async enqueueTask(task) {
-    await redis.lpush(TASK_QUEUE_KEY, JSON.stringify(task));
-  }
-  async resumeForCatch(workflowId, newState, catchStep) {
-    const key = this.getKey(workflowId);
-    await redis.hset(key, {
-      state: JSON.stringify(newState),
-      status: WorkflowStatus.RUNNING,
-      step: catchStep.toString()
-    });
-  }
-};
-var DurableRuntime = class {
-  durableFns = /* @__PURE__ */ new Map();
-  repo = new WorkflowRepository();
-  workerId = randomUUID();
-  isRunning = false;
-  schedulerInterval = null;
-  sourceRoot;
-  constructor(options) {
-    this.sourceRoot = options.sourceRoot;
-  }
-  async start(durableFn, options, parentId) {
-    if (options.workflowId) {
-      const existing = await this.repo.get(options.workflowId);
-      if (existing && existing.status !== WorkflowStatus.COMPLETED && existing.status !== WorkflowStatus.FAILED) {
-        throw new Error(
-          `Workflow with ID '${options.workflowId}' already exists and is in a running state (${existing.status}).`
-        );
-      }
-    }
-    const workflowId = options.workflowId ?? randomUUID();
-    console.log(`[RUNTIME] Iniciando workflow '${durableFn.name}' con ID: ${workflowId}`);
-    await this.repo.create({
-      workflowId,
-      name: durableFn.name,
-      status: WorkflowStatus.RUNNING,
-      input: options.input,
-      parentId
-    });
-    this.scheduleExecution(workflowId, durableFn);
-    return workflowId;
-  }
-  async scheduleExecution(workflowId, durableFn, lastResult, initialError) {
-    setImmediate(() => {
-      this._executeStep(workflowId, durableFn, lastResult, initialError).catch(
-        (err) => {
-          console.error(
-            `[RUNTIME-FATAL] Error no manejado en la ejecuci\xF3n del workflow ${workflowId}`,
-            err
-          );
-        }
-      );
-    });
-  }
-  async _executeStep(workflowId, durableFn, lastResult, initialError) {
-    const hasLock = await this.repo.acquireLock(workflowId);
-    if (!hasLock) {
-      console.log(
-        `[RUNTIME-LOCK] No se pudo adquirir el bloqueo para ${workflowId}, otro proceso est\xE1 trabajando. Se omitir\xE1 este ciclo.`
-      );
-      return;
-    }
-    let executionError = null;
-    try {
-      if (initialError) {
-        throw initialError;
-      }
-      const instance = await this.repo.get(workflowId);
-      if (!instance) return;
-      if (instance.status !== WorkflowStatus.RUNNING) {
-        console.log(
-          `[RUNTIME] Se intent\xF3 ejecutar el workflow ${workflowId} pero su estado es ${instance.status}. Omitiendo.`
-        );
-        return;
-      }
-      const context = {
-        workflowId,
-        step: instance.step,
-        input: instance.input,
-        state: instance.state,
-        result: lastResult,
-        log: (message) => console.log(`[WF:${workflowId}] ${message}`)
-      };
-      const instruction = await durableFn.execute(context);
-      await this.repo.updateState(workflowId, context.state);
-      await this.handleInstruction(instruction, context, instance.name);
-    } catch (error) {
-      executionError = error instanceof Error ? error : new Error(String(error));
-      console.error(`[RUNTIME] Error en workflow ${workflowId}:`, executionError);
-    } finally {
-      await this.repo.releaseLock(workflowId);
-    }
-    if (executionError) {
-      await this.handleFailure(workflowId, executionError, durableFn);
-    }
-  }
-  async handleInstruction(instruction, context, durableFunctionName) {
-    const { workflowId } = context;
-    switch (instruction.type) {
-      case "SCHEDULE_TASK": {
-        await this.repo.enqueueTask({
-          workflowId,
-          durableFunctionName,
-          ...instruction
-        });
-        break;
-      }
-      case "SCHEDULE_SLEEP": {
-        const durationMs = ms(instruction.duration);
-        if (typeof durationMs !== "number") {
-          throw new Error(
-            `Invalid time value provided to bSleep: "${instruction.duration}"`
-          );
-        }
-        const wakeUpAt = Date.now() + durationMs;
-        await this.repo.scheduleSleep(workflowId, wakeUpAt);
-        break;
-      }
-      case "WAIT_FOR_EVENT": {
-        await this.repo.updateStatus(workflowId, WorkflowStatus.AWAITING_EVENT, {
-          awaitingEvent: instruction.eventName
-        });
-        await redis.sadd(`events:awaiting:${instruction.eventName}`, workflowId);
-        break;
-      }
-      case "EXECUTE_SUBWORKFLOW": {
-        const subDurableFn = this.durableFns.get(instruction.workflowName);
-        if (!subDurableFn)
-          throw new Error(
-            `Sub-workflow '${instruction.workflowName}' no encontrado.`
-          );
-        const subWorkflowId = await this.start(
-          subDurableFn,
-          { input: instruction.input },
-          workflowId
-        );
-        await this.repo.updateStatus(
-          workflowId,
-          WorkflowStatus.AWAITING_SUBWORKFLOW,
-          { subWorkflowId }
-        );
-        break;
-      }
-      case "COMPLETE": {
-        await this.repo.complete(workflowId, instruction.result);
-        await this.resumeParentWorkflow(workflowId);
-        break;
-      }
-    }
-  }
-  async handleFailure(workflowId, error, durableFn) {
-    const hasLock = await this.repo.acquireLock(workflowId, 20);
-    if (!hasLock) {
-      console.warn(
-        `[RUNTIME-FAIL] No se pudo adquirir lock para manejar fallo en ${workflowId}. Reintentando m\xE1s tarde...`
-      );
-      return;
-    }
-    try {
-      const instance = await this.repo.get(workflowId);
-      if (!instance || instance.status === WorkflowStatus.FAILED) return;
-      const stack = instance.state.tryCatchStack;
-      if (stack && stack.length > 0) {
-        const handler = stack.pop();
-        const nextStep = handler?.catchStep;
-        if (nextStep !== void 0) {
-          console.log(
-            `[RUNTIME-FAIL] Excepci\xF3n capturada en ${workflowId}. Saltando a la cl\xE1usula CATCH en el paso ${nextStep}.`
-          );
-          await this.repo.resumeForCatch(workflowId, instance.state, nextStep);
-          this.scheduleExecution(workflowId, durableFn, {
-            name: error.name,
-            message: error.message,
-            stack: error.stack
-          });
-          return;
-        }
-      }
-      console.error(`[RUNTIME] Error no capturado en workflow ${workflowId}:`, error);
-      await this.repo.fail(workflowId, error);
-      await this.propagateFailureToParent(workflowId, error);
-    } finally {
-      await this.repo.releaseLock(workflowId);
-    }
-  }
-  async resumeParentWorkflow(completedWorkflowId) {
-    const completedInstance = await this.repo.get(completedWorkflowId);
-    if (!completedInstance?.parentId) return;
-    const parentId = completedInstance.parentId;
-    const parentInstance = await this.repo.get(parentId);
-    if (!parentInstance || parentInstance.status !== WorkflowStatus.AWAITING_SUBWORKFLOW || parentInstance.subWorkflowId !== completedWorkflowId) {
-      return;
-    }
-    console.log(`[RUNTIME] Reanudando workflow padre ${parentId}.`);
-    const durableFn = this.durableFns.get(parentInstance.name);
-    if (!durableFn) {
-      await this.repo.fail(
-        parentId,
-        new Error(`Definici\xF3n del workflow '${parentInstance.name}' no encontrada.`)
-      );
-      return;
-    }
-    await this.repo.updateStatus(parentId, WorkflowStatus.RUNNING, { subWorkflowId: "" });
-    await this.repo.incrementStep(parentId);
-    this.scheduleExecution(parentId, durableFn, completedInstance.result);
-  }
-  async propagateFailureToParent(failedWorkflowId, error) {
-    const failedInstance = await this.repo.get(failedWorkflowId);
-    if (!failedInstance?.parentId) return;
-    const parentId = failedInstance.parentId;
-    const parentInstance = await this.repo.get(parentId);
-    if (!parentInstance || parentInstance.status !== WorkflowStatus.AWAITING_SUBWORKFLOW || parentInstance.subWorkflowId !== failedWorkflowId) {
-      return;
-    }
-    console.log(
-      `[RUNTIME] Propagando fallo del sub-workflow ${failedWorkflowId} al padre ${parentId}.`
-    );
-    const durableFn = this.durableFns.get(parentInstance.name);
-    if (!durableFn) {
-      await this.repo.fail(
-        parentId,
-        new Error(
-          `Definici\xF3n del workflow '${parentInstance.name}' no encontrada al propagar fallo.`
-        )
-      );
-      return;
-    }
-    await this.repo.updateStatus(parentId, WorkflowStatus.RUNNING, { subWorkflowId: "" });
-    const propagationError = new Error(
-      `Sub-workflow '${failedInstance.name}' (${failedWorkflowId}) fall\xF3: ${error.message}`
-    );
-    propagationError.stack = error.stack;
-    this.scheduleExecution(parentId, durableFn, void 0, propagationError);
-  }
-  async sendEvent(workflowId, eventName, payload) {
-    let hasLock = false;
-    for (let i = 0; i < 3; i++) {
-      hasLock = await this.repo.acquireLock(workflowId);
-      if (hasLock) {
-        break;
-      }
-      await new Promise((resolve2) => setTimeout(resolve2, 50));
-    }
-    if (!hasLock) {
-      console.warn(
-        `[RUNTIME-LOCK] No se pudo adquirir el bloqueo para sendEvent en ${workflowId}. El evento podr\xEDa ser descartado o retrasado.`
-      );
-      return;
-    }
-    try {
-      const instance = await this.repo.get(workflowId);
-      if (!instance) {
-        console.warn(
-          `[RUNTIME] Se intent\xF3 enviar un evento a un workflow no existente: ${workflowId}`
-        );
-        return;
-      }
-      if (instance.status !== WorkflowStatus.AWAITING_EVENT || instance.awaitingEvent !== eventName) {
-        console.warn(
-          `[RUNTIME] El workflow ${workflowId} no est\xE1 esperando el evento '${eventName}'. Estado actual: ${instance.status}, esperando: ${instance.awaitingEvent}.`
-        );
-        return;
-      }
-      console.log(
-        `[RUNTIME] Evento '${eventName}' recibido para el workflow ${workflowId}. Reanudando...`
-      );
-      const durableFn = this.durableFns.get(instance.name);
-      if (!durableFn) {
-        console.error(
-          `[RUNTIME] La definici\xF3n de la funci\xF3n durable '${instance.name}' no se encontr\xF3 para el workflow ${workflowId}.`
-        );
-        await this.repo.fail(
-          workflowId,
-          new Error(`Funci\xF3n durable '${instance.name}' no encontrada.`)
-        );
-        return;
-      }
-      await this.repo.updateStatus(workflowId, WorkflowStatus.RUNNING, {
-        awaitingEvent: ""
-      });
-      await redis.srem(`events:awaiting:${eventName}`, workflowId);
-      await this.repo.incrementStep(workflowId);
-      this.scheduleExecution(workflowId, durableFn, payload);
-    } catch (error) {
-      console.error(
-        `[RUNTIME] Error procesando el evento '${eventName}' para el workflow ${workflowId}:`,
-        error
-      );
-      await this.repo.fail(
-        workflowId,
-        new Error(
-          `Fallo al procesar el evento: ${error instanceof Error ? error.message : String(error)}`
-        )
-      );
-    } finally {
-      await this.repo.releaseLock(workflowId);
-    }
-  }
-  startScheduler() {
-    if (this.schedulerInterval) return;
-    console.log("[SCHEDULER] Scheduler iniciado.");
-    const checkSleepers = async () => {
-      const workflowIds = await this.repo.getWorkflowsToWake();
-      for (const workflowId of workflowIds) {
-        const instance = await this.repo.get(workflowId);
-        if (instance) {
-          const durableFn = this.durableFns.get(instance.name);
-          if (durableFn) {
-            console.log(`[SCHEDULER] Reanudando workflow ${workflowId}`);
-            await this.repo.updateStatus(
-              workflowId,
-              WorkflowStatus.RUNNING
-            );
-            await this.repo.incrementStep(workflowId);
-            this.scheduleExecution(workflowId, durableFn, null);
-          }
-        }
-      }
-    };
-    this.schedulerInterval = setInterval(checkSleepers, 2e3);
-  }
-  startWorker() {
-    if (this.isRunning) return;
-    this.isRunning = true;
-    const processingQueueKey = `${TASK_QUEUE_KEY}:processing:${this.workerId}`;
-    console.log(`[WORKER] Worker ${this.workerId} iniciado, esperando tareas...`);
-    const listenForTasks = async () => {
-      while (this.isRunning) {
-        try {
-          const taskString = await blockingRedis.brpoplpush(
-            TASK_QUEUE_KEY,
-            processingQueueKey,
-            0
-          );
-          if (!taskString) continue;
-          const task = JSON.parse(taskString);
-          console.log(`[WORKER] Tarea recibida: ${task.exportName}`);
-          try {
-            let module;
-            if (task.modulePath.startsWith("virtual:")) {
-              module = await import(task.modulePath);
-            } else {
-              const moduleFullPath = resolve(
-                this.sourceRoot,
-                task.modulePath
-              );
-              module = await import(moduleFullPath);
-            }
-            const serviceFn = module[task.exportName];
-            if (typeof serviceFn !== "function")
-              throw new Error(
-                `'${task.exportName}' no es una funci\xF3n.`
-              );
-            const serviceResult = await serviceFn(...task.args);
-            const durableFn = this.durableFns.get(task.durableFunctionName);
-            if (durableFn) {
-              await this.repo.incrementStep(task.workflowId);
-              this.scheduleExecution(
-                task.workflowId,
-                durableFn,
-                serviceResult
-              );
-            }
-            await redis.lrem(processingQueueKey, 1, taskString);
-          } catch (taskError) {
-            const err = taskError instanceof Error ? taskError : new Error(String(taskError));
-            console.error(
-              `[WORKER] Falla en la tarea '${task.exportName}' para workflow ${task.workflowId}`,
-              err
-            );
-            const durableFn = this.durableFns.get(task.durableFunctionName);
-            if (durableFn) {
-              await this.handleFailure(task.workflowId, err, durableFn);
-            } else {
-              await this.repo.fail(
-                task.workflowId,
-                new Error(
-                  `Definici\xF3n de workflow ${task.durableFunctionName} no encontrada durante el manejo de fallos.`
-                )
-              );
-            }
-            console.log(
-              `[WORKER] Eliminando tarea procesada (con error manejado): ${task.exportName}`
-            );
-            await redis.lrem(processingQueueKey, 1, taskString);
-          }
-        } catch (error) {
-          if (!this.isRunning) break;
-          console.error("[WORKER] Error de infraestructura:", error);
-          await new Promise((resolve2) => setTimeout(resolve2, 5e3));
-        }
-      }
-    };
-    listenForTasks();
-  }
-  run(durableFns) {
-    this.durableFns = durableFns;
-    this.startWorker();
-    this.startScheduler();
-  }
-  stop() {
-    this.isRunning = false;
-    if (this.schedulerInterval) {
-      clearInterval(this.schedulerInterval);
-    }
-    console.log("[RUNTIME] Solicitando detenci\xF3n...");
-  }
-};
+if redis.call("get", lockKey) == token then
+    redis.call("hset", workflowKey, "status", status, "result", result)
+    return 1
+else
+    return 0
+end
+`,$=`
+local lockKey = KEYS[1]
+local workflowKey = KEYS[2]
+local token = ARGV[1]
+local errorMsg = ARGV[2]
+local status = ARGV[3]
 
-// src/define.ts
-var bDurable = (def) => {
-  return def;
-};
+if redis.call("get", lockKey) == token then
+    redis.call("hset", workflowKey, "status", status, "error", errorMsg)
+    return 1
+else
+    return 0
+end
+`,G=`
+    local limit = tonumber(ARGV[1])
+    local now = tonumber(ARGV[2])
+    local key = KEYS[1]
+    
+    local ids = redis.call('zrangebyscore', key, 0, now, 'LIMIT', 0, limit)
+    if #ids > 0 then
+        redis.call('zrem', key, unpack(ids))
+    end
+    return ids
+`,U=`
+    local sourceZSet = KEYS[1]
+    local destList = KEYS[2]
+    local now = tonumber(ARGV[1])
+    local limit = tonumber(ARGV[2])
 
-// src/index.ts
-function bDurableInitialize(options) {
-  console.log("--- Inicializando Sistema Durable ---");
-  configurePersistence({
-    commandClient: options.redisClient,
-    blockingClient: options.blockingRedisClient
-  });
-  const runtime = new DurableRuntime({ sourceRoot: options.sourceRoot });
-  runtime.run(options.durableFunctions);
-  return {
-    start: runtime.start.bind(runtime),
-    sendEvent: (durableFn, workflowId, eventName, payload) => {
-      return runtime.sendEvent(workflowId, eventName, payload);
-    },
-    stop: runtime.stop.bind(runtime),
-    runtime
-  };
-}
-export {
-  bDurable,
-  bDurableInitialize
-};
+    -- Obtener tareas listas (score <= now)
+    local tasks = redis.call('zrangebyscore', sourceZSet, 0, now, 'LIMIT', 0, limit)
+    
+    if #tasks > 0 then
+        redis.call('zrem', sourceZSet, unpack(tasks))
+        -- Pushear cada tarea a la lista de ejecuci\xF3n
+        for i, task in ipairs(tasks) do
+            redis.call('lpush', destList, task)
+        end
+    end
+    
+    return #tasks
+`;import M from"superjson";function h(i){return M.stringify(i)}function m(i){try{return M.parse(i)}catch(t){try{return JSON.parse(i)}catch(e){throw new Error(`Failed to deserialize data: ${t} ${e}`)}}}var Y={info:(i,t)=>console.log(`[INFO] ${i}`,t||""),error:(i,t)=>console.error(`[ERROR] ${i}`,t||""),warn:(i,t)=>console.warn(`[WARN] ${i}`,t||""),debug:(i,t)=>console.debug(`[DEBUG] ${i}`,t||"")},K=class{constructor(t){this.retention=t}getKey(t){return`workflow:${t}`}getLockKey(t){return`workflow:${t}:lock`}async acquireLock(t,e=10){let s=this.getLockKey(t),n=W();return await l.set(s,n,"EX",e,"NX")==="OK"?n:null}async releaseLock(t,e){await l.eval(P,1,this.getLockKey(t),e)}async renewLock(t,e,s){return await l.eval(D,1,this.getLockKey(t),e,s)===1}async get(t){let e=await l.hgetall(this.getKey(t));return!e||Object.keys(e).length===0?null:{workflowId:e.workflowId,name:e.name,version:e.version,status:e.status,step:parseInt(e.step,10),input:m(e.input),state:m(e.state),result:e.result?m(e.result):void 0,error:e.error,parentId:e.parentId,subWorkflowId:e.subWorkflowId,awaitingSignal:e.awaitingSignal||e.awaitingEvent,createdAt:e.createdAt?parseInt(e.createdAt,10):0,updatedAt:e.updatedAt?parseInt(e.updatedAt,10):0}}async create(t){let e=Date.now(),s={...t,step:0,state:{},createdAt:e,updatedAt:e},n={...s,input:h(s.input),state:h(s.state)};n.version===void 0&&delete n.version;let r=l.pipeline();r.hset(this.getKey(s.workflowId),n),await r.exec()}async updateState(t,e,s,n){if(await l.eval(A,2,this.getLockKey(t),this.getKey(t),n,h(e),Date.now(),s)===0)throw new Error(`Lock lost for workflow ${t}`)}async updateStatus(t,e,s={}){await l.hset(this.getKey(t),{status:e,...s,updatedAt:Date.now()})}async incrementStep(t,e){let s=await l.eval(_,2,this.getLockKey(t),this.getKey(t),e);if(s===-1)throw new Error(`Lock lost for workflow ${t}`);return s}async applyRetention(t){if(this.retention){let e=v(this.retention)/1e3;e>0&&await l.expire(this.getKey(t),e)}}async complete(t,e,s){if(await l.eval(F,2,this.getLockKey(t),this.getKey(t),s,h(e??null),c.COMPLETED)===0)throw new Error(`Lock lost for workflow ${t}`);await this.applyRetention(t)}async fail(t,e,s,n=c.FAILED){s?await l.eval($,2,this.getLockKey(t),this.getKey(t),s,e.message,n)===0&&console.warn(`Could not fail workflow ${t} safely: Lock lost.`):await l.hset(this.getKey(t),{status:n,error:e.message}),await this.applyRetention(t)}async scheduleSleep(t,e){await this.updateStatus(t,c.SLEEPING),await l.zadd(I,e,t)}async getWorkflowsToWake(t=100){let e=Date.now();return await l.eval(G,1,I,t,e)}async enqueueTask(t){await l.lpush(E,h(t))}async resumeForCatch(t,e,s,n){if(await l.eval(A,2,this.getLockKey(t),this.getKey(t),n,h(e),Date.now(),s)===0)throw new Error(`Lock lost for workflow ${t}`);await l.hset(this.getKey(t),{status:c.RUNNING})}async moveToDLQ(t,e){let s={...t,failedAt:Date.now(),error:e.message,stack:e.stack};await l.lpush(x,h(s))}async scheduleTaskRetry(t,e){let s=Date.now()+e;await l.zadd(L,s,h(t))}async moveDueTasksToQueue(t=100){return await l.eval(U,2,L,E,Date.now(),t)}},b=class{durableFns=new Map;repo;workerId=W();isRunning=!1;schedulerInterval=null;heartbeatInterval=null;sourceRoot;pollingInterval;logger;maxTaskRetries=3;constructor(t){this.sourceRoot=t.sourceRoot,this.repo=new K(t.retention),this.pollingInterval=t.pollingInterval||5e3,this.logger=t.logger||Y}async getState(t){let e=await this.repo.get(t);return e?{workflowId:e.workflowId,name:e.name,version:e.version,status:e.status,step:e.step,input:e.input,output:e.result,state:e.state,error:e.error,createdAt:e.createdAt,updatedAt:e.updatedAt}:null}async start(t,e,s){let n=e.workflowId||W();if(e.workflowId){let r=await this.repo.get(e.workflowId);if(r&&r.status!==c.COMPLETED&&r.status!==c.FAILED)throw new Error(`Workflow with ID '${e.workflowId}' already exists and is in a running state (${r.status}).`)}return this.logger.info(`[RUNTIME] Iniciando workflow '${t.name}' v${t.version} con ID: ${n}`),await this.repo.create({workflowId:n,name:t.name,version:t.version,status:c.RUNNING,input:e.input,parentId:s}),setImmediate(()=>{this._executeStep(n,t).catch(r=>{this.logger.error("Error fatal en ejecuci\xF3n inicial",{error:r,workflowId:n})})}),{workflowId:n,unsubscribe:async()=>{}}}async scheduleExecution(t,e,s,n){setImmediate(()=>{this._executeStep(t,e,s,n).catch(r=>{this.logger.error("Error no manejado en scheduleExecution",{error:r,workflowId:t})})})}async _executeStep(t,e,s,n){let r=await this.repo.acquireLock(t);if(!r)return;let o=setInterval(()=>{this.repo.renewLock(t,r,10).catch(a=>this.logger.warn(`Error renovando lock para ${t}`,{error:a}))},5e3);try{if(n)throw n;let a=await this.repo.get(t);if(!a)return;if(a.status===c.CANCELLING)throw new S(a.error||"Workflow cancelled");if(a.status!==c.RUNNING)return;let p=a.version==="undefined"?void 0:a.version,d=e.version==="undefined"?void 0:e.version;if(String(p??"")!==String(d??"")){let w=new Error(`Version mismatch: DB=${p}, Code=${d}`);await this.repo.fail(t,w,r,c.VERSION_MISMATCH);return}let u={workflowId:t,step:a.step,input:a.input,state:a.state,result:s,log:(w,T)=>this.logger.info(w,{...T,workflowId:t,step:a.step})},g=await e.execute(u);await this.repo.updateState(t,u.state,u.step,r),await this.handleInstruction(g,u,a.name,r)&&(await this.repo.incrementStep(t,r),this.scheduleExecution(t,e,void 0))}catch(a){let p=a instanceof Error?a:new Error(String(a));this.logger.error("Error en workflow",{workflowId:t,error:p.message}),await this.handleFailure(t,p,e,r)}finally{clearInterval(o),await this.repo.releaseLock(t,r)}}async handleInstruction(t,e,s,n){let{workflowId:r}=e;switch(t.type){case"SCHEDULE_TASK":return await this.repo.enqueueTask({workflowId:r,durableFunctionName:s,...t}),!1;case"SCHEDULE_SLEEP":{let o=v(t.duration);if(typeof o!="number")throw new Error(`Invalid time value provided to bSleep: "${t.duration}"`);let a=Date.now()+o;return await this.repo.scheduleSleep(r,a),!1}case"WAIT_FOR_SIGNAL":return await this.repo.updateStatus(r,c.AWAITING_SIGNAL,{awaitingSignal:t.signalName}),await l.sadd(`signals:awaiting:${t.signalName}`,r),!1;case"EXECUTE_SUBWORKFLOW":{let o=this.durableFns.get(t.workflowName);if(!o)throw new Error(`Sub-workflow '${t.workflowName}' no encontrado.`);let{workflowId:a}=await this.start(o,{input:t.input},r);return await this.repo.updateStatus(r,c.AWAITING_SUBWORKFLOW,{subWorkflowId:a}),!1}case"EMIT_EVENT":{let o=`event:${r}`,a=h({eventName:t.eventName,payload:t.payload});return await l.publish(o,a),!0}case"COMPLETE":{let o=`event:${r}`,a=h({eventName:"workflow:completed",payload:t.result});return await l.publish(o,a),await this.repo.complete(r,t.result,n),await this.resumeParentWorkflow(r),!1}}}async handleFailure(t,e,s,n){let r=n;if(!r&&(r=await this.repo.acquireLock(t,20),!r)){this.logger.warn(`No se pudo adquirir lock para fallo en ${t}`);return}try{if(e instanceof S){await this.repo.fail(t,e,r,c.CANCELLED);let u=await this.repo.get(t);u?.subWorkflowId&&await this.cancel(u.subWorkflowId,`Parent workflow ${t} was cancelled`);return}let o=await this.repo.get(t);if(!o||o.status===c.FAILED||o.status===c.COMPLETED)return;let a=o.state.tryCatchStack;if(a&&a.length>0){let g=a.pop()?.catchStep;if(g!==void 0){this.logger.info(`Capturando error en step ${g}`,{workflowId:t}),await this.repo.resumeForCatch(t,o.state,g,r),this.scheduleExecution(t,s,{name:e.name,message:e.message,stack:e.stack});return}}let p=`event:${t}`,d=h({eventName:"workflow:failed",payload:{message:e.message}});await l.publish(p,d),await this.repo.fail(t,e,r),await this.propagateFailureToParent(t,e)}finally{!n&&r&&await this.repo.releaseLock(t,r)}}async resumeParentWorkflow(t){let e=await this.repo.get(t);if(!e?.parentId)return;let s=e.parentId,n=await this.repo.get(s);if(!n||n.status!==c.AWAITING_SUBWORKFLOW||n.subWorkflowId!==t)return;let r=this.durableFns.get(n.name);if(!r){await this.repo.fail(s,new Error(`Definici\xF3n del workflow '${n.name}' no encontrada.`),null);return}await this.repo.updateStatus(s,c.RUNNING,{subWorkflowId:""});let o=await this.repo.acquireLock(s);if(o)try{await this.repo.incrementStep(s,o),this.scheduleExecution(s,r,e.result)}finally{await this.repo.releaseLock(s,o)}else throw this.logger.warn(`Could not lock parent ${s} to resume. Retrying later...`),new Error(`Temporary Lock Failure: Could not acquire parent lock for ${s}`)}async propagateFailureToParent(t,e){let s=await this.repo.get(t);if(!s?.parentId)return;let n=s.parentId,r=await this.repo.get(n);if(!r||r.status!==c.AWAITING_SUBWORKFLOW||r.subWorkflowId!==t)return;let o=this.durableFns.get(r.name);if(!o){await this.repo.fail(n,new Error(`Definici\xF3n del workflow '${r.name}' no encontrada al propagar fallo.`),null);return}await this.repo.updateStatus(n,c.RUNNING,{subWorkflowId:""});let a=new Error(`Sub-workflow '${s.name}' (${t}) fall\xF3: ${e.message}`);a.stack=e.stack,this.scheduleExecution(n,o,void 0,a)}async signal(t,e,s){let n=null;for(let r=0;r<3&&(n=await this.repo.acquireLock(t),!n);r++)await new Promise(o=>setTimeout(o,50));if(!n)return this.logger.warn("Lock timeout en signal",{workflowId:t});try{let r=await this.repo.get(t);if(!r)return this.logger.warn("Se\xF1al para workflow inexistente",{workflowId:t});if(r.status!==c.AWAITING_SIGNAL||r.awaitingSignal!==e)return this.logger.warn("Workflow no esperaba esta se\xF1al",{workflowId:t,expected:r.awaitingSignal,received:e});let o=this.durableFns.get(r.name);if(!o){await this.repo.fail(t,new Error(`Funci\xF3n durable '${r.name}' no encontrada.`),n);return}await this.repo.updateStatus(t,c.RUNNING,{awaitingSignal:""}),await l.srem(`signals:awaiting:${e}`,t),await this.repo.incrementStep(t,n),this.scheduleExecution(t,o,s)}catch(r){let o=r instanceof Error?r:new Error(String(r)),a=(await this.repo.get(t))?.name||"",p=this.durableFns.get(a);await this.handleFailure(t,o,p,n)}finally{n&&await this.repo.releaseLock(t,n)}}async cancel(t,e){let s=await this.repo.acquireLock(t);if(!s)return await new Promise(n=>setTimeout(n,100)),this.cancel(t,e);try{let n=await this.repo.get(t);if(!n||[c.COMPLETED,c.FAILED,c.CANCELLED].includes(n.status))return;if(await this.repo.updateStatus(t,c.CANCELLING,{error:e}),n.status===c.SLEEPING){await l.zrem(I,t);let r=this.durableFns.get(n.name);this.scheduleExecution(t,r)}if(n.status===c.AWAITING_SIGNAL){let r=this.durableFns.get(n.name);this.scheduleExecution(t,r)}}finally{await this.repo.releaseLock(t,s)}}startScheduler(){if(this.schedulerInterval)return;this.logger.info(`Scheduler iniciado (${this.pollingInterval}ms)`);let t=async()=>{await this.checkSleepers(),await this.checkDelayedTasks(),await this.reapDeadWorkers()};this.schedulerInterval=setInterval(t,this.pollingInterval)}async checkDelayedTasks(){try{let t=await this.repo.moveDueTasksToQueue(50);t>0&&this.logger.debug(`Scheduler movi\xF3 ${t} tareas diferidas a la cola activa`)}catch(t){this.logger.error("Error chequeando tareas diferidas",{error:t})}}async checkSleepers(){let e=await this.repo.getWorkflowsToWake(50);e.length!==0&&await Promise.all(e.map(async s=>{let n=await this.repo.acquireLock(s);if(n)try{let r=await this.repo.get(s);if(r){let o=this.durableFns.get(r.name);o&&(this.logger.info("Despertando workflow",{workflowId:s}),await this.repo.updateStatus(s,c.RUNNING),await this.repo.incrementStep(s,n),this.scheduleExecution(s,o,void 0))}}finally{await this.repo.releaseLock(s,n)}}))}async reapDeadWorkers(){let t="0";do{let[e,s]=await l.sscan(k,t,"COUNT",100);t=e;for(let n of s){if(await l.exists(`${R}${n}`))continue;this.logger.warn(`Worker muerto ${n}. Recuperando tareas.`);let r=`${E}:processing:${n}`,o=await l.rpoplpush(r,E);for(;o;)o=await l.rpoplpush(r,E);await l.del(r),await l.srem(k,n)}}while(t!=="0")}startHeartbeat(){let t=`${R}${this.workerId}`,e=Math.max(Math.ceil(this.pollingInterval*3/1e3),5),s=()=>{this.isRunning&&l.set(t,Date.now().toString(),"EX",e).catch(()=>{})};this.heartbeatInterval=setInterval(s,this.pollingInterval),s()}startWorker(){if(this.isRunning)return;this.isRunning=!0;let t=`${E}:processing:${this.workerId}`;this.logger.info(`Worker ${this.workerId} iniciado`),this.startHeartbeat(),(async()=>{for(await l.sadd(k,this.workerId);this.isRunning;)try{let s=await y.brpoplpush(E,t,2);if(!s)continue;let n=m(s);this.logger.debug(`Ejecutando tarea: ${n.exportName}`,{workflowId:n.workflowId});try{let r;n.modulePath.startsWith("virtual:")?r=await import(n.modulePath):r=await import(V(this.sourceRoot,n.modulePath));let o=r[n.exportName];if(typeof o!="function")throw new Error(`'${n.exportName}' no es una funci\xF3n.`);let a=await o(...n.args),p=this.durableFns.get(n.durableFunctionName);if(p){let d=await this.repo.acquireLock(n.workflowId);if(d)try{await this.repo.incrementStep(n.workflowId,d),this.scheduleExecution(n.workflowId,p,a)}finally{await this.repo.releaseLock(n.workflowId,d)}else this.logger.warn(`No se pudo adquirir lock para avanzar workflow ${n.workflowId} tras tarea`,{task:n.exportName})}await l.lrem(t,1,s)}catch(r){let o=r instanceof Error?r:new Error(String(r));this.logger.error(`Fallo en tarea ${n.exportName}`,{workflowId:n.workflowId,error:o.message});let a=this.durableFns.get(n.durableFunctionName),p=a?.retryOptions||{},d=p.maxAttempts??3,u=(n.attempts||0)+1;if(n.attempts=u,u<=d){let g=p.initialInterval?v(p.initialInterval):1e3,f=p.backoffCoefficient??2,w=p.maxInterval?v(p.maxInterval):36e5,T=g*Math.pow(f,u-1);T>w&&(T=w),this.logger.warn(`Reintentando tarea en ${v(T)} (intento ${u}/${d===1/0?"Inf":d})`,{workflowId:n.workflowId}),T>0?await this.repo.scheduleTaskRetry(n,T):await l.lpush(E,h(n)),await l.lrem(t,1,s)}else this.logger.error("Reintentos agotados. Moviendo a DLQ.",{workflowId:n.workflowId}),await this.repo.moveToDLQ(n,o),a?await this.handleFailure(n.workflowId,o,a,null):await this.repo.fail(n.workflowId,new Error(`Def missing for ${n.durableFunctionName}`),null),await l.lrem(t,1,s)}}catch(s){if(!this.isRunning)break;this.logger.error("Error infraestructura worker",{error:s}),await new Promise(n=>setTimeout(n,5e3))}})()}run(t){this.durableFns=t,this.startWorker(),this.startScheduler()}async stop(){this.isRunning=!1,this.schedulerInterval&&clearInterval(this.schedulerInterval),this.heartbeatInterval&&clearInterval(this.heartbeatInterval),await l.srem(k,this.workerId),this.logger.info("Runtime detenido")}};var H=i=>({...i,__isDurable:!0});var B={info:(i,t)=>console.log(`[INFO] ${i}`,t||""),error:(i,t)=>console.error(`[ERROR] ${i}`,t||""),warn:(i,t)=>console.warn(`[WARN] ${i}`,t||""),debug:(i,t)=>console.debug(`[DEBUG] ${i}`,t||"")},Q=i=>{if(!i.startsWith("on")||i.length<=2)return null;let t=i.slice(2);return t.charAt(0).toLowerCase()+t.slice(1)};function Rt(i){let t=i.logger||B;t.info("--- Inicializando Sistema Durable ---"),N({commandClient:i.redisClient,blockingClient:i.blockingRedisClient});let e=new b({sourceRoot:i.sourceRoot,retention:i.retention,pollingInterval:i.pollingInterval,logger:t});e.run(i.durableFunctions);let s=new q(i.redisClient.options),n=new Map;s.psubscribe("event:*",o=>{o&&t.error("Error fatal al suscribirse a los canales de eventos:",{error:o})}),s.on("pmessage",(o,a,p)=>{let d=n.get(a);if(d&&d.length>0)try{let u=m(p),g={name:u.eventName||u.signalName,payload:u.payload};[...d].forEach(f=>f(g))}catch(u){t.error(`Error al parsear evento en ${a}`,{error:u})}});let r=(o,a)=>{let p=`event:${a}`,d=u=>(n.has(p)||n.set(p,[]),n.get(p)?.push(u),()=>{let g=n.get(p);if(g){let f=g.indexOf(u);f>-1&&g.splice(f,1),g.length===0&&n.delete(p)}});return{workflowId:a,signal:async(u,g)=>{await e.signal(a,u,g)},on:async(u,g)=>{let f=C(a),w=await i.redisClient.hgetall(f);return u==="workflow:completed"&&w.status===c.COMPLETED?(g(m(w.result||"null")),{unsubscribe:()=>{}}):u==="workflow:failed"&&w.status===c.FAILED?(g({message:w.error||"Unknown"}),{unsubscribe:()=>{}}):{unsubscribe:d(O=>{O.name===u&&g(O.payload)})}},subscribe:async u=>({unsubscribe:d(f=>{u(f)})})}};return{start:async(o,a)=>{let p=a.workflowId||z(),d=[],u=`event:${p}`,g={};if(Object.keys(a).forEach(f=>{let w=Q(f);w&&typeof a[f]=="function"&&(g[w]=a[f])}),Object.keys(g).length>0){n.has(u)||n.set(u,[]);let f=w=>{let T=g[w.name];T&&T(w.payload)};n.get(u)?.push(f),d.push(()=>{let w=n.get(u);if(w){let T=w.indexOf(f);T>-1&&w.splice(T,1)}})}return await e.start(o,{workflowId:p,input:a.input}),{workflowId:p,unsubscribe:async()=>{d.forEach(f=>f())}}},stop:()=>{e.stop(),s.quit().catch(()=>{})},runtime:e,cancel:(o,a)=>e.cancel(o,a),getState:o=>e.getState(o),getHandle:(o,a)=>r(o,a)}}export{S as WorkflowCancellationError,H as bDurable,Rt as bDurableInitialize};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobtail.software/b-durable",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "main": "dist/index.mjs",
   "types": "dist/index.d.mts",
   "description": "A system for creating durable, resilient, and type-safe workflows in JavaScript/TypeScript.",
@@ -25,6 +25,7 @@
     "ms": "^2.1.3",
     "pino": "^10.1.0",
     "prettier": "^3.6.2",
+    "superjson": "^2.2.5",
     "ts-morph": "^27.0.2"
   },
   "devDependencies": {