INJECUTE_UNDO_FAILED

A lifecycle hook could not be undone.

How to fix it

Its undo function threw, rejected, or did not finish before the stop signal aborted. The hook is in path, the original error in cause.

Where you see it

running.stop() runs every undo function, even when some fail, then rejects with INJECUTE_DISPOSE_FAILED. Each failed undo is an INJECUTE_UNDO_FAILED in cause.errors, with the hook in path:

try {
  await running.stop({ signal: AbortSignal.timeout(25_000) });
} catch (error) {
  for (const failure of (error as InjecuteError).cause.errors) {
    if (failure.code === 'INJECUTE_UNDO_FAILED') {
      console.error(failure.path[0], failure.cause); // which hook, and why
    }
  }
}

After a failed start, the rollback reports them to onError with during: 'rollback'. An undo that "did not finish before the signal aborted" keeps running in the background. See Startup and shutdown.

Handling it in code

import { InjecuteError } from 'injecute';

try {
  // ...
} catch (error) {
  if (error instanceof InjecuteError && error.code === 'INJECUTE_UNDO_FAILED') {
    // error.message explains what happened; error.path is the resolution chain
  }
}

All error codes