Method finish

src/node/utils/oauthFlowManager.ts:164–202

* Finish a flow: resolve the deferred, clear the timeout, close the server, * and remove the entry from the map. * * Idempotent — no-op if the flow was already removed. Mirrors the * `finishDesktopFlow` pattern.

(flowId: string, result: Result<void, string>)

   * `finishDesktopFlow` pattern.
   */
  async finish(flowId: string, result: Result<void, string>): Promise<void> {
    const flow = this.flows.get(flowId);
    if (!flow) return;

    // Remove from map first to make re-entrant calls no-ops.
    this.flows.delete(flowId);

    if (flow.timeoutHandle !== null) {
      clearTimeout(flow.timeoutHandle);
    }

    // Preserve the final result briefly so late waiters can still retrieve it.
    //
    // Old per-service DesktopFlow implementations kept completed flows around for
    // ~60s (cleanupTimeout) to avoid a race where the OAuth callback finishes
    // before the frontend begins `waitFor`-ing.
    this.clearCompleted(flowId);
    const cleanupTimeout = setTimeout(() => {
      this.completed.delete(flowId);
    }, this.completedFlowTtlMs);

    // Don't keep the node process alive just to delete old completed entries.
    if (typeof cleanupTimeout !== "number") {
      cleanupTimeout.unref?.();
    }

    this.completed.set(flowId, { result, cleanupTimeout });

    try {
      flow.resultDeferred.resolve(result);

      if (flow.server) {
        // Stop accepting new connections.
        await closeServer(flow.server);
      }
    } catch (error) {
      log.debug("Failed to close OAuth callback listener:", error);
    }
  }

  /**
   * Shut down all active flows — resolves each with an error.