@bobtail.software/b-durable 1.0.5 → 1.0.6

package/dist/index.mjs

@@ -1,551 +1 @@
-// 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;
-}
-
-// src/runtime/runtime.ts
-import { randomUUID } from "crypto";
-import ms from "ms";
-import { resolve } from "path";
-
-// 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"
-};
-
-// 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...");
-  }
-};
-
-// src/define.ts
-var bDurable = (def) => {
-  return def;
-};
-
-// 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
-};
+import P from"ioredis";var w="queue:tasks",m="durable:sleepers",v="worker:heartbeat:",W="queue:dead";function O(u){return`workflow:${u}`}var l={RUNNING:"RUNNING",SLEEPING:"SLEEPING",COMPLETED:"COMPLETED",FAILED:"FAILED",AWAITING_EVENT:"AWAITING_EVENT",AWAITING_SUBWORKFLOW:"AWAITING_SUBWORKFLOW",CANCELLING:"CANCELLING",CANCELLED:"CANCELLED",VERSION_MISMATCH:"VERSION_MISMATCH"};var o,E;function N(u){if(o||E){console.warn("[Persistence] Los clientes de Redis ya han sido configurados. Omitiendo.");return}o=u.commandClient,E=u.blockingClient}import{randomUUID as R}from"crypto";import L from"ms";import{resolve as D}from"path";var k=class extends Error{isCancellation=!0;constructor(t){super(t),this.name="WorkflowCancellationError"}};var x={info:(u,t)=>console.log(`[INFO] ${u}`,t||""),error:(u,t)=>console.error(`[ERROR] ${u}`,t||""),warn:(u,t)=>console.warn(`[WARN] ${u}`,t||""),debug:(u,t)=>console.debug(`[DEBUG] ${u}`,t||"")},I=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);return await o.set(s,"locked","EX",e,"NX")==="OK"}async releaseLock(t){await o.del(this.getLockKey(t))}async get(t){let e=await o.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:JSON.parse(e.input),state:JSON.parse(e.state),result:e.result?JSON.parse(e.result):void 0,error:e.error,parentId:e.parentId,subWorkflowId:e.subWorkflowId,awaitingEvent: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:JSON.stringify(s.input),state:JSON.stringify(s.state)};n.version===void 0&&delete n.version;let a=o.pipeline();a.hset(this.getKey(s.workflowId),n),await a.exec()}async updateState(t,e){await o.hset(this.getKey(t),{state:JSON.stringify(e),updatedAt:Date.now()})}async updateStatus(t,e,s={}){await o.hset(this.getKey(t),{status:e,...s,updatedAt:Date.now()})}async incrementStep(t){return o.hincrby(this.getKey(t),"step",1)}async applyRetention(t){if(this.retention){let e=L(this.retention)/1e3;e>0&&await o.expire(this.getKey(t),e)}}async complete(t,e){await o.hset(this.getKey(t),{status:l.COMPLETED,result:JSON.stringify(e??null)}),await this.applyRetention(t)}async fail(t,e,s=l.FAILED){await o.hset(this.getKey(t),{status:s,error:e.message}),await this.applyRetention(t)}async scheduleSleep(t,e){await this.updateStatus(t,l.SLEEPING),await o.zadd(m,e,t)}async getWorkflowsToWake(){let t=Date.now(),e=await o.zrangebyscore(m,0,t);return e.length>0&&await o.zrem(m,...e),e}async enqueueTask(t){await o.lpush(w,JSON.stringify(t))}async resumeForCatch(t,e,s){let n=this.getKey(t);await o.hset(n,{state:JSON.stringify(e),status:l.RUNNING,step:s.toString()})}async moveToDLQ(t,e){let s={...t,failedAt:Date.now(),error:e.message,stack:e.stack};await o.lpush(W,JSON.stringify(s))}},S=class{durableFns=new Map;repo;workerId=R();isRunning=!1;schedulerInterval=null;heartbeatInterval=null;sourceRoot;pollingInterval;logger;maxTaskRetries=3;constructor(t){this.sourceRoot=t.sourceRoot,this.repo=new I(t.retention),this.pollingInterval=t.pollingInterval||5e3,this.logger=t.logger||x}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){if(e.workflowId){let r=await this.repo.get(e.workflowId);if(r&&r.status!==l.COMPLETED&&r.status!==l.FAILED)throw new Error(`Workflow with ID '${e.workflowId}' already exists and is in a running state (${r.status}).`)}let n=e.workflowId??R();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:l.RUNNING,input:e.input,parentId:s});let a=async()=>{};if(e.subscribe){let r=o.duplicate(),i=`signal:${n}`;r.on("message",(c,g)=>{if(c===i)try{let p=JSON.parse(g),f={name:p.signalName,payload:p.payload};e.subscribe?.(f)}catch(p){this.logger.error("Error al procesar se\xF1al",{error:p,workflowId:n})}}),await r.subscribe(i),a=async()=>{r.status==="ready"&&(r.unsubscribe(i).catch(()=>{}),r.quit().catch(()=>{}))}}return setImmediate(()=>{this._executeStep(n,t).catch(r=>{this.logger.error("Error fatal en ejecuci\xF3n inicial",{error:r,workflowId:n})})}),{workflowId:n,unsubscribe:a}}async scheduleExecution(t,e,s,n){setImmediate(()=>{this._executeStep(t,e,s,n).catch(a=>{this.logger.error("Error no manejado en scheduleExecution",{error:a,workflowId:t})})})}async _executeStep(t,e,s,n){if(await this.repo.acquireLock(t))try{if(n)throw n;let r=await this.repo.get(t);if(!r)return;if(r.status===l.CANCELLING)throw new k(r.error||"Workflow cancelled");if(r.status!==l.RUNNING)return;let i=r.version==="undefined"?void 0:r.version,c=e.version==="undefined"?void 0:e.version;if(String(i??"")!==String(c??"")){let d=new Error(`Version mismatch: DB=${i}, Code=${c}`);await this.repo.fail(t,d,l.VERSION_MISMATCH);return}let g={workflowId:t,step:r.step,input:r.input,state:r.state,result:s,log:(d,T)=>this.logger.info(d,{...T,workflowId:t,step:r.step})},p=await e.execute(g);await this.repo.updateState(t,g.state),await this.handleInstruction(p,g,r.name)&&(await this.repo.incrementStep(t),this.scheduleExecution(t,e,void 0))}catch(r){let i=r instanceof Error?r:new Error(String(r));this.logger.error("Error en workflow",{workflowId:t,error:i.message}),await this.handleFailure(t,i,e,!0)}finally{await this.repo.releaseLock(t)}}async handleInstruction(t,e,s){let{workflowId:n}=e;switch(t.type){case"SCHEDULE_TASK":return await this.repo.enqueueTask({workflowId:n,durableFunctionName:s,...t}),!1;case"SCHEDULE_SLEEP":{let a=L(t.duration);if(typeof a!="number")throw new Error(`Invalid time value provided to bSleep: "${t.duration}"`);let r=Date.now()+a;return await this.repo.scheduleSleep(n,r),!1}case"WAIT_FOR_EVENT":return await this.repo.updateStatus(n,l.AWAITING_EVENT,{awaitingEvent:t.eventName}),await o.sadd(`events:awaiting:${t.eventName}`,n),!1;case"EXECUTE_SUBWORKFLOW":{let a=this.durableFns.get(t.workflowName);if(!a)throw new Error(`Sub-workflow '${t.workflowName}' no encontrado.`);let{workflowId:r}=await this.start(a,{input:t.input},n);return await this.repo.updateStatus(n,l.AWAITING_SUBWORKFLOW,{subWorkflowId:r}),!1}case"SEND_SIGNAL":{let a=`signal:${n}`,r=JSON.stringify({signalName:t.signalName,payload:t.payload});return await o.publish(a,r),!0}case"COMPLETE":{let a=`signal:${n}`,r=JSON.stringify({signalName:"workflow:completed",payload:t.result});return await o.publish(a,r),await this.repo.complete(n,t.result),await this.resumeParentWorkflow(n),!1}}}async handleFailure(t,e,s,n=!1){if(!n&&!await this.repo.acquireLock(t,20)){this.logger.warn(`No se pudo adquirir lock para fallo en ${t}`);return}try{if(e instanceof k){await this.repo.fail(t,e,l.CANCELLED);let g=await this.repo.get(t);g?.subWorkflowId&&await this.cancel(g.subWorkflowId,`Parent workflow ${t} was cancelled`);return}let a=await this.repo.get(t);if(!a||a.status===l.FAILED||a.status===l.COMPLETED)return;let r=a.state.tryCatchStack;if(r&&r.length>0){let p=r.pop()?.catchStep;if(p!==void 0){this.logger.info(`Capturando error en step ${p}`,{workflowId:t}),await this.repo.resumeForCatch(t,a.state,p),this.scheduleExecution(t,s,{name:e.name,message:e.message,stack:e.stack});return}}let i=`signal:${t}`,c=JSON.stringify({signalName:"workflow:failed",payload:{message:e.message}});await o.publish(i,c),await this.repo.fail(t,e),await this.propagateFailureToParent(t,e)}finally{n||await this.repo.releaseLock(t)}}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!==l.AWAITING_SUBWORKFLOW||n.subWorkflowId!==t)return;let a=this.durableFns.get(n.name);if(!a){await this.repo.fail(s,new Error(`Definici\xF3n del workflow '${n.name}' no encontrada.`));return}await this.repo.updateStatus(s,l.RUNNING,{subWorkflowId:""}),await this.repo.incrementStep(s),this.scheduleExecution(s,a,e.result)}async propagateFailureToParent(t,e){let s=await this.repo.get(t);if(!s?.parentId)return;let n=s.parentId,a=await this.repo.get(n);if(!a||a.status!==l.AWAITING_SUBWORKFLOW||a.subWorkflowId!==t)return;let r=this.durableFns.get(a.name);if(!r){await this.repo.fail(n,new Error(`Definici\xF3n del workflow '${a.name}' no encontrada al propagar fallo.`));return}await this.repo.updateStatus(n,l.RUNNING,{subWorkflowId:""});let i=new Error(`Sub-workflow '${s.name}' (${t}) fall\xF3: ${e.message}`);i.stack=e.stack,this.scheduleExecution(n,r,void 0,i)}async sendEvent(t,e,s){let n=!1;for(let a=0;a<3&&(n=await this.repo.acquireLock(t),!n);a++)await new Promise(r=>setTimeout(r,50));if(!n)return this.logger.warn("Lock timeout en sendEvent",{workflowId:t});try{let a=await this.repo.get(t);if(!a)return this.logger.warn("Evento para workflow inexistente",{workflowId:t});if(a.status!==l.AWAITING_EVENT||a.awaitingEvent!==e)return this.logger.warn("Workflow no esperaba este evento",{workflowId:t,expected:a.awaitingEvent,received:e});let r=this.durableFns.get(a.name);if(!r){await this.repo.fail(t,new Error(`Funci\xF3n durable '${a.name}' no encontrada.`));return}await this.repo.updateStatus(t,l.RUNNING,{awaitingEvent:""}),await o.srem(`events:awaiting:${e}`,t),await this.repo.incrementStep(t),this.scheduleExecution(t,r,s)}catch(a){let r=a instanceof Error?a:new Error(String(a)),i=(await this.repo.get(t))?.name||"",c=this.durableFns.get(i);await this.handleFailure(t,r,c,!0)}finally{await this.repo.releaseLock(t)}}async cancel(t,e){if(!await this.repo.acquireLock(t))return await new Promise(n=>setTimeout(n,100)),this.cancel(t,e);try{let n=await this.repo.get(t);if(!n||[l.COMPLETED,l.FAILED,l.CANCELLED].includes(n.status))return;if(await this.repo.updateStatus(t,l.CANCELLING,{error:e}),n.status===l.SLEEPING){await o.zrem(m,t);let a=this.durableFns.get(n.name);this.scheduleExecution(t,a)}if(n.status===l.AWAITING_EVENT){let a=this.durableFns.get(n.name);this.scheduleExecution(t,a)}}finally{await this.repo.releaseLock(t)}}startScheduler(){if(this.schedulerInterval)return;this.logger.info(`Scheduler iniciado (${this.pollingInterval}ms)`);let t=async()=>{await this.checkSleepers(),await this.reapDeadWorkers()};this.schedulerInterval=setInterval(t,this.pollingInterval)}async checkSleepers(){let t=await this.repo.getWorkflowsToWake();for(let e of t){let s=await this.repo.get(e);if(s){let n=this.durableFns.get(s.name);n&&(this.logger.info("Despertando workflow",{workflowId:e}),await this.repo.updateStatus(e,l.RUNNING),await this.repo.incrementStep(e),this.scheduleExecution(e,n,void 0))}}}async reapDeadWorkers(){let t=await o.keys(`${w}:processing:*`);for(let e of t){let s=e.split(":").pop();if(!s||await o.exists(`${v}${s}`))continue;this.logger.warn(`Worker muerto ${s}. Recuperando tareas.`);let n=await o.rpoplpush(e,w);for(;n;)n=await o.rpoplpush(e,w);await o.del(e)}}startHeartbeat(){let t=`${v}${this.workerId}`,e=Math.max(Math.ceil(this.pollingInterval*3/1e3),5),s=()=>{this.isRunning&&o.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=`${w}:processing:${this.workerId}`;this.logger.info(`Worker ${this.workerId} iniciado`),this.startHeartbeat(),(async()=>{for(;this.isRunning;)try{let s=await E.brpoplpush(w,t,0);if(!s)continue;let n=JSON.parse(s);this.logger.debug(`Ejecutando tarea: ${n.exportName}`,{workflowId:n.workflowId});try{let a;n.modulePath.startsWith("virtual:")?a=await import(n.modulePath):a=await import(D(this.sourceRoot,n.modulePath));let r=a[n.exportName];if(typeof r!="function")throw new Error(`'${n.exportName}' no es una funci\xF3n.`);let i=await r(...n.args),c=this.durableFns.get(n.durableFunctionName);c&&(await this.repo.incrementStep(n.workflowId),this.scheduleExecution(n.workflowId,c,i)),await o.lrem(t,1,s)}catch(a){let r=a instanceof Error?a:new Error(String(a));this.logger.error(`Fallo en tarea ${n.exportName}`,{workflowId:n.workflowId,error:r.message});let i=(n.attempts||0)+1;if(i<=this.maxTaskRetries)this.logger.warn(`Reintentando tarea (intento ${i}/${this.maxTaskRetries})`,{workflowId:n.workflowId}),n.attempts=i,await o.lpush(w,JSON.stringify(n)),await o.lrem(t,1,s);else{this.logger.error("Reintentos agotados. Moviendo a DLQ.",{workflowId:n.workflowId}),await this.repo.moveToDLQ(n,r);let c=this.durableFns.get(n.durableFunctionName);c?await this.handleFailure(n.workflowId,r,c):await this.repo.fail(n.workflowId,new Error(`Def missing for ${n.durableFunctionName}`)),await o.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()}stop(){this.isRunning=!1,this.schedulerInterval&&clearInterval(this.schedulerInterval),this.heartbeatInterval&&clearInterval(this.heartbeatInterval),this.logger.info("Runtime detenido")}};var F=u=>({...u,__isDurable:!0});var A={info:(u,t)=>console.log(`[INFO] ${u}`,t||""),error:(u,t)=>console.error(`[ERROR] ${u}`,t||""),warn:(u,t)=>console.warn(`[WARN] ${u}`,t||""),debug:(u,t)=>console.debug(`[DEBUG] ${u}`,t||"")};function it(u){let t=u.logger||A;t.info("--- Inicializando Sistema Durable ---");let e=new P(u.redisClient.options),s=new Map;e.psubscribe("signal:*",r=>{r&&t.error("Error fatal al suscribirse a los canales de se\xF1ales:",{error:r})}),e.on("pmessage",(r,i,c)=>{let g=s.get(i);if(g&&g.length>0)try{let p=JSON.parse(c),f={name:p.signalName,payload:p.payload};[...g].forEach(d=>d(f))}catch(p){t.error(`Error al parsear mensaje de se\xF1al en ${i}`,{error:p})}});let n=(r,i)=>{let c=()=>{};return{workflowId:i,subscribe:async g=>{let p=`signal:${i}`,f=O(i),d=await u.redisClient.hgetall(f);if(d.status===l.COMPLETED)return g({name:"workflow:completed",payload:JSON.parse(d.result||"null")},c),{unsubscribe:c};if(d.status===l.FAILED)return g({name:"workflow:failed",payload:{message:d.error||"Unknown error"}},c),{unsubscribe:c};let T=null,b=()=>{if(!T)return;let h=s.get(p);if(h){let y=h.indexOf(T);y>-1&&h.splice(y,1),h.length===0&&s.delete(p)}};return T=h=>{g(h,b)},s.has(p)||s.set(p,[]),s.get(p)?.push(T),{unsubscribe:b}}}};N({commandClient:u.redisClient,blockingClient:u.blockingRedisClient});let a=new S({sourceRoot:u.sourceRoot,retention:u.retention,pollingInterval:u.pollingInterval,logger:t});return a.run(u.durableFunctions),{start:async(r,i)=>a.start(r,i),cancel:(r,i)=>a.cancel(r,i),getState:r=>a.getState(r),getWorkflowHandle:(r,i)=>n(r,i),sendEvent:(r,i,c,g)=>a.sendEvent(i,c,g),stop:()=>{a.stop(),e.quit().catch(()=>{})},runtime:a}}export{k as WorkflowCancellationError,F as bDurable,it as bDurableInitialize};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobtail.software/b-durable",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "main": "dist/index.mjs",
   "types": "dist/index.d.mts",
   "description": "A system for creating durable, resilient, and type-safe workflows in JavaScript/TypeScript.",